gary-dso-skills

English | 中文

A standalone collection of DSO content-production skills for Codex and other Agents-compatible hosts. Every skill lives in its own top-level directory and can be installed independently.

What This Repo Does

1. Run one topic or a multi-post batch through research, validated page copy, structural template matching, distinct batch templates, standalone SVG production, and same-size PNG export (gary-dso-workflow).
2. Produce a writing-only package with current primary-source research and claim-level confidence (gary-dso-writer).
3. Match validated copy to structure-verified templates and produce traceable SVG page sets (gary-dso-templates).
4. Keep workflow contracts, deterministic checks, and release gates in one versioned repository.

Included Skills

1) gary-dso-workflow

The public end-to-end production entrypoint:

• Calls gary-dso-writer first and gary-dso-templates second.
• Passes one versioned dso-standard-v1 capacity profile to both Skills.
• Requires valid research and writing results before visual production.
• Preserves the Writer's form, page count, page order, and copy verbatim.
• Produces one standalone SVG and one same-size PNG per page plus render-manifest.json.
• Defaults to one visual variant and creates more only when requested.
• Requires a distinct template set for every item in an explicitly diverse content batch.
• Never uses HTML screenshots as deliverables and never uses PNG to bypass a failed SVG; PNG is rasterized only after SVG validation.

2) gary-dso-writer

The public writing-only entrypoint:

• Researches current facts from primary sources.
• Scores claim confidence and keeps every used fact traceable.
• Selects comparison, three-part, four-part, or article form from the evidence.
• Writes all page copy, publication copy, and exactly five hashtags.
• Validates cover, detail, summary, and service-boundary slots against the shared profile instead of page-count-specific totals.
• Delivers five validated JSON assets and stops before visual production.

3) gary-dso-templates

The public layout and template entrypoint:

• Selects layouts by content structure rather than topic.
• Synchronizes technically verified SVG bundles into a versioned candidate library without modifying an active extraction directory.
• Hard-matches complete template sets by writing form, page roles, block shape, and declared text capacity.
• Admits only sets whose physical slot maxima cover the shared profile, so one Writer package can render through multiple visual variants.
• Preserves validated Writer packages page-for-page and character-for- character.
• Owns SVG template selection, copy injection, browser-measured overflow and bounded fit checks, page SVG generation, and direct PNG rasterization.
• Inlines referenced images and fonts so every delivered page SVG is standalone.
• Records template IDs, selection exclusions, SVG/PNG files, hashes, dimensions, and fit diagnostics in a manifest.
• Publishes the complete local SVG library with explicit public-distribution metadata while keeping review and fixed_pending_retest bundles out of runtime selection until their technical QA is complete.

Template extraction and legacy generator tools are maintained in a separate local-only environment and are intentionally excluded from the public repository. This repository contains the validated, distributable template library consumed by gary-dso-templates.

Project Structure

gary-dso-skills/
├── gary-dso-workflow/
│   ├── SKILL.md
│   ├── agents/
│   └── scripts/
├── gary-dso-writer/
│   ├── SKILL.md
│   ├── agents/
│   ├── references/
│   └── scripts/
├── gary-dso-templates/
│   ├── SKILL.md
│   ├── agents/
│   ├── assets/
│   ├── references/
│   └── scripts/
├── docs/
│   ├── development.md
│   └── gary-dso-workflow.md
├── scripts/
│   ├── validate_repository.py
│   └── test_skills.py
├── AGENTS.md
├── README.md
├── README.zh.md
└── .gitignore

Raw captures, generated deliverables, logs, and scratch environments stay in ignored local directories: archives/, outputs/, logs/, and .tmp/. Each public Skill also writes task artifacts only to its ignored <skill>/output/<run-id>/ directory. See the output directory contract.

Requirements

• Codex or another host that loads SKILL.md directories.
• Python 3.11+.
• Pillow for the Python image renderers.
• The three public skills installed as siblings for the complete workflow.
• Node.js, Playwright, and Chromium for final SVG layout measurement and PNG export in the complete workflow.
• lark-shared and lark-doc only when the user explicitly requests a Feishu distribution document.

Installation

Copy the three public skill directories into a loaded skills directory:

mkdir -p ~/.agents/skills
cp -R \
  gary-dso-workflow \
  gary-dso-writer \
  gary-dso-templates \
  ~/.agents/skills/

Common destinations include:

• Agents: ~/.agents/skills/
• Codex custom skill path: ~/.codex/skills/
• Claude Code: ~/.claude/skills/

Keep directory names unchanged and start a new session after installation.

Quick Start

Create a complete local DSO SVG/PNG package:

Use $gary-dso-workflow to turn “澳洲 WHV 申请流程” into a validated DSO
writing package and final paired page-by-page SVG and PNG content.

Create a six-post batch with six different templates:

Use $gary-dso-workflow to create six related posts, use a different compatible
template for every post, and deliver paired SVG and PNG pages.

Create only the researched writing package:

Use $gary-dso-writer to research “澳洲 WHV 申请流程” and write the complete
page-by-page DSO copy without visual production.

Produce SVG pages from an existing validated writing package:

Use $gary-dso-templates to preserve this validated Writer package verbatim and
produce one SVG file per page plus a render manifest.

Development

Run repository validation and all current unit tests:

python3 scripts/validate_repository.py
python3 scripts/test_skills.py

See docs/development.md for repository development and docs/gary-dso-workflow.md for the complete SVG handoff, artifact, and failure contract. Agent-specific repository rules live in AGENTS.md.

Security and Data Boundaries

• Never commit credentials, cookies, customer data, private chats, or institution data.
• Raw template previews and OCR output remain local and are not production templates.
• The complete source-faithful SVG library in gary-dso-templates/assets/svg-library/ is intended for public distribution. Its binary images and fonts require Git LFS; public distribution and technical production_ready status are recorded separately in the catalog.
• New generated content must record template IDs, SVG paths and hashes, fit diagnostics, and the exact page structure in render-manifest.json.
• The active template inventory is gary-dso-templates/assets/svg-library/svg-template-catalog.json; its rights and production-state fields must remain authoritative.
• Creating Feishu documents, publishing content, or performing any other external write requires explicit user authorization.

License

The repository uses separate licenses for code and creative assets:

• Skill instructions, scripts, documentation, and other original source code: MIT License.
• Original SVG templates and template catalog metadata under gary-dso-templates/assets/svg-library/: CC BY 4.0.
• Third-party fonts, images, icons, and other external materials retain their original licenses. Check bundle metadata and asset-specific license files before redistributing them.

Both the MIT-licensed code and the CC BY-licensed original templates may be used commercially. CC BY reuse requires attribution and an indication of changes.