| name | skill-creator |
| version | 2.0.0 |
| description | Create SKILL.md files. Use when building domain skills, packaging workflows, or codifying conventions. |
| allowed-tools | ["Read","Write","Edit","Grep","Glob","Terminal","AskQuestions"] |
Skill Creator
Maximum information compression. Every word earns its place. What readers infer, omit.
Interview first: domain, triggers, pain points, paths, validation, done-criteria → maps directly to skill sections.
Location: .github/skills/<name>/SKILL.md
Anatomy
YAML Frontmatter name, description ("Use when" triggers)
Title One line
Paths Table: role → glob
Gate "Before X: Check Y"
Patterns Copy-paste blocks (no placeholders)
Checklist Done = all checked
Omit what doesn't apply.
Compression Principles
| Principle | ✗ Verbose | ✓ Compressed |
|---|
| Imperative | "You should use..." | "Use" |
| Show don't tell | "The function should report" | "Reports" |
| Examples > prose | "Format paths as tables because…" | | Rules | src/rules/*.ts | |
| Inference | "Since TypeScript compiles to…" | (omit—reader knows) |
| Signpost | Re-explain AST traversal here | See eslint-rules skill |
| Bold = mandatory | "Consider reusing" | MUST REUSE |
| Code = exact | doThing(<your-value>) | doThing('actual-value') |
Test: Delete a word. Meaning lost? Keep it. Otherwise, cut.
Description Field
Agent sees only description when choosing. ≤1024 chars · Third person · "Use when [triggers]."
✓ Extract/fill/merge PDFs. Use when working with PDF files or forms.
✗ Helps with documents.
Boundaries
Include: this repo's paths, conventions, gotchas.
Exclude: domain fundamentals, language syntax, tool installation—reader knows or finds elsewhere.
Split & Script
Split to REFERENCE.md at ~100 lines or distinct sub-domains.
Add script when: deterministic, repeated, needs explicit error handling.
Checklist