build · alirezarezvani — Claude Code command: what it does, how to install
build — a guided command for creating skills, prompts, agents, and hooks. Use it when you want the factory workflow to generate and check a new artifact.
MIT ★ 907 updated 2025-11-12
.claude/commands/build.mdWhat build does
/build starts the factory-guide orchestrator. With no argument, it asks which kind of artifact you want and routes the work to the matching specialist. You can choose a path directly with /build skill, /build prompt, /build agent, or /build hook.
The selected flow asks between 3 and 11 questions, creates the requested files, checks format and quality, then gives installation and testing guidance. A skill flow produces a folder and ZIP archive; an agent flow writes an .md file; a hook flow creates hook.json and README.md with validation. The command will not appear in Claude Code without .claude/commands/build.md.
After generation, you can run /validate-output, install the resulting skill or hook, and test it with the factory commands. Use a direct argument when you already know which artifact you want to create.
What it helps with
- create a skill for a defined task
- generate a prompt for an LLM
- write an agent definition file
- build a workflow hook
- validate generated output
Example prompts for the agent
- Create a skill for checking payment integrations with
/build skill. - Generate a prompt for processing support requests using
/build prompt. - Build a hook that runs tests after an agent finishes with
/build hook.
How to install build
Manually: put the files in place
.claude/commands/build.mdCall it with /build. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/build.mdCall it with /prompts:build. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/build.prompt.mdManually: put the files in place
.gemini/commands/build.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about build
How do I install build in Claude Code?
Place the command file at .claude/commands/build.md in your Claude Code project.
What does build do?
It starts factory-guide, which walks you through creating a skill, prompt, agent, or hook. The flow asks questions, generates files, and provides checks and setup guidance.
What is the difference between /build and /build skill?
/build first asks what you want to create. /build skill sends the request straight to the skills specialist and starts that question flow.
Source text
build.md · MIT
# /build - Start Building Skills, Prompts, Agents, or Hooks **Quick access to the factory-guide orchestrator for building custom Skills, Prompts, Agents, or Hooks.** --- ## Usage ``` /build /build skill /build prompt /build agent /build hook ``` --- ## What This Command Does **Without arguments** (`/build`): - Invokes the **factory-guide** orchestrator - Asks what you want to build (Skill, Prompt, Agent, or Hook) - Delegates to appropriate specialist - Guides you through complete process **With argument** (`/build skill|prompt|agent|hook`): - Directly delegates to the specialist: - `/build skill` → **skills-guide** agent - `/build prompt` → **prompts-guide** agent - `/build agent` → **agents-guide** agent - `/build hook` → **hooks-guide** agent --- ## Examples ### Build Anything (Guided) ``` /build ``` **Output**: ``` Welcome to the Claude Code Skills Factory! 🏭 What would you like to create today? 1. Claude Skill (multi-file capability) 2. Mega-Prompt (for any LLM) 3. Claude Agent (workflow specialist) 4. Claude Hook (workflow automation) Enter 1, 2, 3, or 4: ___ ``` --- ### Build a Skill (Direct) ``` /build skill ``` **Output**: ``` Let's build your custom Claude Skill! I'll ask you 4-5 straightforward questions. Question 1: What's your business type or domain? Examples: FinTech, Healthcare, E-commerce, SaaS Your answer: ___ ``` → Continues with skills-guide agent's question flow → Generates complete skill folder + ZIP --- ### Build a Prompt (Direct) ``` /build prompt ``` **Output**: ``` I'll help you generate a mega-prompt using the prompt-factory skill. Quick-Start Preset (30 seconds) or Custom Prompt (2 minutes)? Choice: ___ ``` → Continues with prompts-guide agent → Generates production-ready prompt --- ### Build an Agent (Direct) ``` /build agent ``` **Output**: ``` Let's build your custom Claude Code Agent! Question 1: What should this agent do? Examples: - Review code for security vulnerabilities - Build React components - Run tests and analyze failures Your agent's purpose: ___ ``` → Continues with agents-guide agent → Generates agent .md file --- ### Build a Hook (Direct) ``` /build hook ``` **Output**: ``` Let's build your custom Claude Code Hook! Question 1: What should this hook do? Examples: - Auto-format code after editing - Run tests when agent completes - Send notifications - Auto-stage files with git Your hook's purpose: ___ ``` → Continues with hooks-guide agent's question flow → Generates hook.json + README.md with validation --- ## What Happens Next ### After Running /build **The orchestrator or specialist will**: 1. Ask you straightforward questions (3-11 total depending on path) 2. Generate complete output (skill/prompt/agent/hook) 3. Validate format and quality 4. Create all necessary files 5. Provide installation instructions 6. Give testing guidance **You'll get**: - Complete, working output - Validated format (YAML, naming, structure) - Installation help - Usage examples --- ## Related Commands **After building**: - `/validate-output skill|hook` - Check format and quality - `/install-skill path/to/skill` - Install generated skill - `/install-hook path/to/hook` - Install generated hook - `/test-factory skill-name` - Test it works - `/factory-status` - See what you've built --- ## Common Workflows ### Build → Validate → Install → Test ``` # 1. Build /build skill [Answer questions, skill generated] # 2. Validate /validate-output skill # 3. Install /install-skill generated-skills/my-skill # 4. Test /test-factory my-skill # 5. Check status /factory-status ``` --- ## Tips **For faster workflow**: - Use `/build skill|prompt|agent|hook` to skip the "what to build" question - Be specific in your initial request - Answer questions with examples when helpful **If unsure**: - Just use `/build` and let factory-guide guide you - The agents will ask clarifying questions - You can always regenerate or customize --- **The simplest way to start building custom Skills, Prompts, Agents, and Hooks!** 🚀
© alirezarezvani · MIT · alirezarezvani/claude-code-skill-factory
Similar slash commands
All slash commands for Agent setup: memory, context, orchestration →build by other authors comes first.