build-skill — Claude Code command: what it does, how to install
build-skill walks a new Claude skill through four agents: requirement questions, file generation, validation, docs. You approve the spec before any file appears.
no license ★ 1,357 updated 2026-03-01
.claude/commands/build-skill.mdWhat build-skill does
The /build-skill command chains four subagents through the Task tool. skill-elicitation-agent asks 3-5 questions about purpose, scope, tool permissions and success criteria, then turns the answers into a spec. Nothing gets generated until you sign off on it.
skill-generator-agent then lays out the folder: SKILL.md with frontmatter, plus reference.md, examples.md, scripts/ and templates/ where the spec asks for them. The target can be a personal skill under ~/.claude/skills/, a project skill or a plugin skill.
skill-validator-agent reads the YAML, checks whether the description carries the keywords that make a skill trigger, follows file references and tests script syntax. It scores each area and sends failures back to the generator for another pass. skill-documenter-agent closes with a README, worked examples and troubleshooting notes. The whole chain assumes those four agents exist in your setup, because the command calls them by name through Task; with none of them installed there is nothing to launch.
What it helps with
- scaffold a
SKILL.mdwhose frontmatter parses - turn a rough idea into a written skill spec
- check trigger keywords before a skill goes live
- lay out scripts and templates folders correctly
- add a README and examples to a finished skill
Example prompts for the agent
/build-skillI want a skill that checks Alembic migrations before each commit/build-skillbuild a changelog skill from git log, project level/build-skillmake a skill with a Python script that validates JSON schemas, personal folder
How to install build-skill
Manually: put the files in place
.claude/commands/build-skill.mdCall it with /build-skill. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/build-skill.mdCall it with /prompts:build-skill. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/build-skill.prompt.mdManually: put the files in place
.gemini/commands/build-skill.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about build-skill
How to install build-skill in Claude Code?
Put the command file into your project at .claude/commands/build-skill.md. From there you call it as /build-skill.
What does build-skill do?
It builds a Claude skill in four stages: gather requirements, generate the files, validate them, write the docs. You get to approve the spec before generation starts.
Which agents does the command run?
skill-elicitation-agent, skill-generator-agent, skill-validator-agent and skill-documenter-agent, launched one after another through the Task tool.