Skill Doc Authoring

Produce a single valid SKILL.md that an agent will actually trigger and follow. The two failure modes this prevents: skills that never fire (weak description) and skills that fire but don't help (vague body).

File contract

• Directory name and name: MUST match, lowercase, hyphens only, ≤ 64 chars.
• Filename MUST be exactly SKILL.md (case-sensitive).
• Frontmatter has exactly two keys: name, description. description ≤ 1024 chars.

skills/<skill-name>/SKILL.md

The description is the trigger

The agent decides whether to load the skill from the description alone. Write it in third person, lead with what it does, then "Use when …" with concrete user phrasings and situations. Include the trigger words a user would actually type.