Create an Agent Skill

Guide the creation of a SKILL.md file that meets quality standards.

Rules

1. One skill, one job. If you need "and" to describe it, split it.

2. Name it well. Prefer gerund form (processing-pdfs). Noun phrases (pdf-processing) and action form (process-pdfs) are fine. Avoid vague names like utils or helpers. Spec limits: lowercase, numbers, and hyphens; max 64 chars; no anthropic or claude.

3. Write the description as a trigger, in third person. It decides when the skill activates. Start with "Use when..." and name a specific condition. First-person phrasing ("I can...") hurts discovery. Max 1024 chars.

   • Bad: "Helps with diagrams."
   • Good: "Use when creating or fixing ASCII box diagrams to ensure proper alignment."

4. Use this structure: