write-a-skill
Installation
SKILL.md
Write A Skill
The meta-skill for building skill packages. It turns standards/skill-authoring-standard.md
from a document you agree with into a gate you can run: scaffold the package, write a
description that actually activates, place content in the right file, and lint against all
11 patterns before anyone reviews it. Most rejected skills fail on two things — a
description nothing matches, and a SKILL.md carrying content that belonged in references/.
When to use this skill
- Creating a new skill from a one-line idea and needing the package structure right the first time
- Reviewing a skill PR and wanting a mechanical pass before spending attention on judgement
- Fixing a skill that never activates despite being well written — almost always a description problem
- Splitting an oversized SKILL.md that has crept past 500 lines
- Auditing a whole domain for description collisions after adding several neighbouring skills
- Onboarding a new author who needs the standard operationalised rather than explained