skill-creator
Create effective skills. Use when creating or updating skills.
When & Why to Use This Skill
The Skill Creator is a specialized framework designed to standardize and optimize the development of Claude agent skills. It provides developers with a rigorous set of principles, structural templates, and best practices to ensure that agentic capabilities are concise, maintainable, and highly effective. By enforcing consistent naming conventions and architectural patterns like progressive disclosure, it helps developers build more reliable AI tools while minimizing context noise.
Use Cases
- Standardizing Agent Development: Establish a consistent structure and naming convention across a library of skills to improve team collaboration and code maintainability.
- Optimizing Instruction Clarity: Use the 'Concise' and 'Progressive Disclosure' principles to ensure AI agents receive only the most relevant information, reducing token waste and improving task accuracy.
- Rapid Skill Bootstrapping: Leverage the provided SKILL.md template and checklist to quickly create new, production-ready agent capabilities from scratch.
- Quality Assurance and Auditing: Apply the anti-pattern guide and validation checklist to refine existing skills, ensuring they meet professional standards for performance and reliability.
| name | skill-creator |
|---|---|
| description | Create effective skills. Use when creating or updating skills. |
| license | UNLICENSE |
| compatibility | opencode |
Skill Creator
Principles
- Concise: Only add context AI doesn't have.
- Progressive disclosure: Metadata → SKILL.md → Resources
- Appropriate freedom: High for flexible, low for fragile tasks.
Structure
skill-name/
├── SKILL.md (required)
└── Optional: scripts/, references/, assets/
- SKILL.md:
name: lowercase, hyphens, max 64 charsdescription: max 1024 chars, third person, what + whencompatibility: opencode- Body: under 500 lines
- Naming: Gerund form (
processing-pdfs,analyzing-data) - Description:
Extract PDF text. Use when working with PDFs.
Formatting
- 80 chars guideline: Exceptions: URLs, code, tables
- Paths: Forward slashes (
scripts/file.py) - Terminology: Consistent throughout
Patterns
Progressive disclosure:
## Quick start
[Instructions]
## Advanced
See [ADVANCED.md](ADVANCED.md)
Workflows with checklist:
- [ ] Analyze
- [ ] Validate
- [ ] Execute
- Feedback loops: Validate → fix → repeat
- Templates:
ALWAYS use: [template]orAdapt as needed: [...] - Examples: Provide input/output pairs
Anti-Patterns
❌ Windows paths, vague descriptions, many options ❌ Time-sensitive info, nested references
Development
- Complete task, notice repeated context
- Create skill with AI
- Test, iterate
Template
---
name: skill-name
description: What it does. Use when [trigger].
license: UNLICENSE
compatibility: opencode
---
# Skill Name
[Instructions]
Checklist:
- Description under 80 chars, third person
- Body under 500 lines, 80 char guideline
- Consistent terminology
- References one level deep
- Tested with real usage