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:

1. Metadata (~27 tokens) – YAML frontmatter for triggering
2. Instructions (<680 tokens) – SKILL.md body with core patterns
3. 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, files

References

• 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