Writing Great Skills Skill

A skill is a promise: given this kind of request, produce this kind of professional output, every time. The best SKILL.md files win on two things — the model triggers them at the right moment, and once triggered it produces the right artifact without hand-holding. This skill helps you write one that does both.

Working from a brief

Given a rough idea ("a skill for writing changelogs"), produce the full SKILL.md anyway — infer the deliverable, inputs, and structure, and mark genuinely open choices. Never hand back a skeleton with <!-- TODO --> left in; fill them.

Required Inputs

Ask for (if not already provided), else infer and label:

• What the skill should do and the concrete artifact it produces
• When it should trigger (the phrasings a user would actually type)
• The inputs it needs from the user
• Any framework or standard it encodes (for attribution)

The anatomy of a great SKILL.md