skill-creator
Design and create Agent Skills using progressive disclosure principles. Use when building new skills, planning skill architecture, or writing skill content.
Overall
score
75%
Does it follow best practices?
Optimize this skill
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation for skill structure
Skill Creator
Create effective Agent Skills using progressive disclosure.
When to Create a Skill
Create a skill when you notice:
- Repeating context across conversations
- Domain expertise needed repeatedly
- Project-specific knowledge the agent should know automatically
Progressive Disclosure
Skills load in 3 levels:
- Metadata (~27 tokens) - YAML frontmatter for triggering
- Instructions (<680 tokens) - SKILL.md body with core patterns
- Resources (unlimited) - references/ scripts/ assets/ loaded on demand
Key: Keep Levels 1 & 2 lean. Move details to Level 3.
Structure
my-skill/
├── SKILL.md # Core instructions + metadata
├── references/ # Detailed docs (loaded as needed)
├── scripts/ # Executable operations
└── assets/ # Templates, images, filesReferences
- quick-start.md - Creating your first skill
- writing-guide.md - Writing effective skills
- development-process.md - Step-by-step workflow
- skill-examples.md - Patterns and examples
- cli-reference.md - CLI tool usage
- agent-skills-resources.md - Architecture and best practices
- Repository
- github.com/hotovo/aider-desk
- Last updated
- Created
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.