Skip to main content
command CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/build-skill.md
Open on GitHub

What 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.md whose 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-skill I want a skill that checks Alembic migrations before each commit
  • /build-skill build a changelog skill from git log, project level
  • /build-skill make 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.md

Call it with /build-skill. For all projects use ~/.claude/commands/

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.

Similar slash commands

All slash commands for Agent setup: memory, context, orchestration →

From the same set112

The whole set →
audit-layer-boundaries audit-layer-boundaries analyzes architectural layer boundaries in Rust projects. It catches mixed responsibilities, misplaced database logic, and boundary leaks. CX Codex +1 ★ 1,357repo stars skill-generator-agent skill-generator-agent turns a skill spec into files on disk: SKILL.md, helper scripts, reference docs. Then it checks frontmatter and layout. CX Codex ★ 1,357repo stars milestone-tracker milestone-tracker aggregates milestone data from Linear, GitHub, and git history to calculate burn-down velocity and spot schedule risks. CX Codex +1 ★ 1,357repo stars audit-dependencies audit-dependencies audits dependency direction in Rust projects and flags layer violations. Use it when reviewing architecture or preparing a refactor. CX Codex +1 ★ 1,357repo stars spec-elicitation spec-elicitation conducts a rigorous interview to turn rough feature concepts into detailed technical specifications before writing code. CX Codex +1 ★ 1,357repo stars audit-ports-adapters The audit-ports-adapters command audits ports and adapters in Rust code, checking trait placement, implementations, and whether use cases depend on abstractions. CX Codex +1 ★ 1,357repo stars project-architect project-architect analyzes project requirements, recommends a tech stack, and scaffolds folder structure for new projects or architecture refactoring. Handles web apps, microservices, monorepos, and backend services. CX Codex ★ 1,357repo stars parallel-tasks parallel-tasks pulls task queues from issue trackers and assigns independent items across multiple parallel agents without file conflicts. CX Codex +1 ★ 1,357repo stars

Project sponsors

Companies that keep this analytics open