write-a-skill
Installation
SKILL.md
Write a Skill
Repo/code changes: run /deslop before commit, push, PR, or merge.
1. Gather Requirements
Ask: domain/task? Primary use cases? Scripts needed? Reference materials? Before new files/scripts, check reuse-first: standard library, native platform, already-installed dependency, one-line instruction.
2. Draft Structure
skill-name/
├── SKILL.md # Main instructions (required, <100 lines)
├── REFERENCE.md # Detailed docs (if SKILL.md would exceed 100 lines)
├── EXAMPLES.md # Usage examples (if needed)
└── scripts/ # Utility scripts (if needed)
3. Description
Max 1024 chars, third person. First sentence: what does. Second: "Use when [triggers]."