Skill Creator

Goal

Create or refine a skill that is easy to trigger, easy to use, and lean in context.

Guardrails

• Frontmatter must include only name and description.
• Description starts with “Use when” and includes trigger conditions.
• Keep SKILL.md under ~500 lines; move details into references/.
• Do not add extra docs like README/CHANGELOG inside a skill.
• Prefer small, composable changes over broad refactors.

Workflow

1. Clarify usage.
   • Collect 2–4 concrete example prompts that should trigger the skill.
2. Decide reusable resources.
   • Identify any scripts, references, or assets that will be reused.
3. Initialize (new skills only).
   • Run scripts/init_skill.py with a hyphenated name.
4. Implement resources.
   • Add scripts/references/assets first; test scripts.
5. Write or refine SKILL.md.
   • Keep instructions imperative, procedural, and concise.
   • Link all reference files directly from SKILL.md.
6. Validate.
   • Run scripts/quick_validate.py <path>.
7. Iterate after real use.
   • Update SKILL.md or references based on observed friction.

Naming Rules

• Lowercase, digits, and hyphens only.
• Under 64 characters.
• Prefer verb-led names (e.g., gh-address-comments).
• Folder name must match name.

Reference Pointers

• skill-creator/references/fundamentals.md: skill anatomy, degrees of freedom, progressive disclosure patterns.
• skill-creator/references/openai_yaml.md: agents/openai.yaml schema and generation.
• skill-creator/references/workflows.md: multi-step workflow patterns.
• skill-creator/references/output-patterns.md: output format templates.