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

Inputs the skill expects

Installs
2
GitHub Stars
447
First Seen
13 days ago
write-a-skill — borghei/claude-skills