YankielDBC2 Skill Authoring
Goal
Create high-quality skills that Codex can discover and apply reliably.
When to use
Use when adding a new skill, improving an existing skill, reviewing skill quality, creating references, or deduplicating overlapping skills.
When not to use
Do not use for normal product implementation unless the task is to update the skill library itself.
Inputs
Inspect the proposed skill purpose, existing similar skills, docs/SKILL_SPEC.md, docs/STYLE_GUIDE.md, and docs/QUALITY_RUBRIC.md.
Workflow
- Define the single job of the skill.
- Search for overlapping skills before creating a new one.
- Write precise activation frontmatter.
- Put the durable process in
SKILL.md. - Move long examples to
references/. - Add scripts only for deterministic checks.
- Run validation and duplicate checks.
- Generate the catalog after changes.
Quality bar
A good skill is narrow, discoverable, safe, testable, and easy to maintain.
Validation
Run npm run validate, npm test, and npm run catalog.
Final response
Report the skill created or changed, why it is not duplicated, validation output, and any future improvement ideas.