skill-builder

Original：🇺🇸 English

Translated

Creates, refines, and validates Claude Code skills following amplihack philosophy and official best practices. Automatically activates when building, creating, generating, or designing new skills.

2installs

Sourcerysweet/amplihack

Added on2026-02-08

NPX Install

npx skill4agent add rysweet/amplihack skill-builder

SKILL.md Content

View Translation Comparison →

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
```
~/.amplihack/.claude/skills/
```
(auto-discovery)

agent: Specialized agents in

~/.amplihack/.claude/agents/amplihack/specialized/

command: Slash commands in

~/.amplihack/.claude/commands/amplihack/

scenario: Production tools in
```
~/.amplihack/.claude/scenarios/
```

See examples.md for detailed examples of each type.

Command Interface

For explicit invocation:

bash

/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

.