skill-creator

hotovo's avatarfrom hotovo

Design and create Agent Skills using progressive disclosure principles. Use when building new skills, planning skill architecture, or writing skill content.

⭐998stars🔀78forks📁View on GitHub🕐Updated Jan 4, 2026

When & Why to Use This Skill

The Skill Creator is a specialized framework designed to streamline the development of Claude Agent Skills through progressive disclosure principles. It provides a standardized architecture for building, planning, and organizing agent capabilities, ensuring that skills are token-efficient, scalable, and easy to maintain by separating core instructions from heavy resources.

Use Cases

  • 1. Efficient Agent Architecture: Designing multi-layered skills that optimize context window usage by loading detailed documentation and scripts only when triggered.
  • 2. Standardizing Development Workflows: Establishing a consistent structure (SKILL.md, references, scripts) for teams building complex AI agent ecosystems.
  • 3. Domain Expertise Packaging: Converting repetitive project-specific knowledge and expert workflows into reusable, modular skills that agents can automatically leverage.
nameskill-creator
descriptionDesign and create Agent Skills using progressive disclosure principles. Use when building new skills, planning skill architecture, or writing skill content.

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