skill-builder
Creates, refines, and validates Claude Code skills following amplihack philosophy and official best practices. Automatically activates when building, creating, generating, or designing new skills.
When & Why to Use This Skill
The Skill Builder is a specialized Claude skill designed to automate the creation, refinement, and validation of production-ready Claude Code skills. By adhering to Anthropic's official best practices and the 'amplihack' philosophy of ruthless simplicity, it ensures that new skills are token-efficient, well-structured, and highly discoverable. It manages the entire development lifecycle—from requirement clarification and architectural design to YAML frontmatter generation and automated quality validation—making it an essential tool for developers building agentic workflows.
Use Cases
- Rapidly bootstrapping new Claude Code skills with standardized SKILL.md structures and optimized YAML frontmatter.
- Refining existing agent instructions to ensure they comply with token budgets (under 5,000 tokens) and performance best practices.
- Automating the generation of comprehensive test cases and edge-case validations for custom slash commands and specialized agents.
- Designing complex multi-file skill architectures using the progressive disclosure pattern for better context management.
- Validating skill quality and philosophy compliance to ensure high-quality discovery and activation within the Claude Code environment.
| name | skill-builder |
|---|---|
| version | 1.0.0 |
| description | Creates, refines, and validates Claude Code skills following amplihack philosophy and official best practices. Automatically activates when building, creating, generating, or designing new skills. |
Skill Builder
Purpose
Helps users create production-ready Claude Code skills that follow best practices from official Anthropic documentation and amplihack's ruthless simplicity philosophy.
When I Activate
I automatically load when you mention:
- "build a skill" or "create a skill"
- "generate a skill" or "make a skill"
- "design a skill" or "develop a skill"
- "skill builder" or "new skill"
- "skill for [purpose]"
What I Do
I orchestrate the skill creation process using amplihack's specialized agents:
Clarify Requirements (prompt-writer agent)
- Understand skill purpose and scope
- Define target users and use cases
- Identify skill type (agent, command, scenario)
Design Structure (architect agent)
- Plan YAML frontmatter fields
- Design skill organization (single vs multi-file)
- Calculate token budget allocation
- Choose appropriate templates
Generate Skill (builder agent)
- Create SKILL.md with proper YAML frontmatter
- Write clear instructions and examples
- Include supporting files if needed
- Follow progressive disclosure pattern
Validate Quality (reviewer agent)
- Check YAML frontmatter syntax
- Verify token budget (<5,000 tokens core)
- Ensure philosophy compliance (>85% score)
- Test description quality for discovery
Create Tests (tester agent)
- Define activation test cases
- Create edge case validations
- Document expected behaviors
Skill Types Supported
- skill: Claude Code skills in
.claude/skills/(auto-discovery) - agent: Specialized agents in
.claude/agents/amplihack/specialized/ - command: Slash commands in
.claude/commands/amplihack/ - scenario: Production tools in
.claude/scenarios/
See examples.md for detailed examples of each type.
Command Interface
For explicit invocation:
/amplihack:skill-builder <skill-name> <skill-type> <description>
Examples in examples.md.
Documentation
Supporting Files (progressive disclosure):
- reference.md: Architecture, patterns, YAML spec, best practices
- examples.md: Real-world usage, testing, troubleshooting
Original Documentation Sources (embedded in reference.md):
- Official Claude Code Skills: https://code.claude.com/docs/en/skills
- Anthropic Agent SDK Skills: https://docs.claude.com/en/docs/agent-sdk/skills
- Agent Skills Engineering Blog: https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills
- Claude Cookbooks - Skills: https://github.com/anthropics/claude-cookbooks/tree/main/skills
- Skills Custom Development Notebook: https://github.com/anthropics/claude-cookbooks/blob/main/skills/notebooks/03_skills_custom_development.ipynb
- metaskills/skill-builder (Reference): https://github.com/metaskills/skill-builder
All documentation is embedded in reference.md for offline access. Links provided for updates and verification.
Note: This skill automatically loads when Claude detects skill building intent. For explicit control, use /amplihack:skill-builder.