Writing Skills

Objective

Produce professional-grade skills: high-signal, safe, portable, and reliably triggerable. This skill:

• Writes or updates a skill directory (SKILL.md + optional scripts/, references/, assets/)
• Generates agents/openai.yaml UI metadata
• Runs validation (skillcheck)
• Runs a critic review using $reviewing-skills and iterates until the bar is met

When to use / When not to use

Use when:

• The user asks to create a new skill (SKILL.md + optional scripts/, references/, assets/).
• The user asks to refactor, tighten, or “upgrade” an existing skill for trigger precision and token efficiency.

Do not use when:

• The user only wants a rubric-based review/grade of an existing skill (use $reviewing-skills).
• The request is not about a skill directory containing SKILL.md.