Skill Creator
Create modular, self-contained packages that extend AI capabilities with specialized knowledge and workflows.
Core Principles
Concise is Key
Challenge each piece: "Does Claude really need this?" Prefer concise examples over verbose explanations.
Progressive Disclosure
- •Metadata (~100 words) - Always loaded
- •SKILL.md body (<500 lines) - When triggered
- •Bundled resources - As needed
Skill Structure
code
skill-name/
├── SKILL.md (required)
│ ├── YAML frontmatter (name, description)
│ └── Markdown instructions
└── Bundled Resources (optional)
├── scripts/ - Executable code
├── references/ - Documentation
└── assets/ - Templates, icons
SKILL.md Format
yaml
--- name: my-skill description: What it does AND when to use it (critical for triggering) --- # Title [Core instructions - imperative form] ## Sections as needed
Best Practices
| Do | Don't |
|---|---|
| Clear, comprehensive description | Vague one-liner |
| Imperative form ("Create", "Run") | Passive voice |
| Concise examples | Verbose explanations |
| Reference files for details | Everything in SKILL.md |
| Test scripts by running them | Assume they work |
What NOT to Include
- •README.md, CHANGELOG.md, INSTALLATION.md
- •User-facing documentation
- •Setup/testing procedures
Creation Process
- •Understand - Get concrete usage examples
- •Plan - Identify reusable scripts/references/assets
- •Initialize - Create skill directory with SKILL.md
- •Edit - Implement resources, write instructions
- •Test - Verify with real usage
- •Iterate - Refine based on feedback