Skip to main content
command CX Codex

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

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

What 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.md

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

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.

build SuperClaude-Org Handles building, compiling, and packaging projects with automatic error detection and artifact optimization. Runs from Claude Code with configurable environments and build types. CX Codex +1 ★ 23,950repo stars build disler build reads a plan file, applies it to your codebase and prints the report section from that plan. Useful once the plan is written and only the implementation is left. CX Codex +1 ★ 3,990repo stars build disler build is a command that reads a plan file and applies its changes to a codebase. It asks for the file path if none is provided. CX Codex +1 ★ 1,573repo stars build microsoft The build command from the Deep Wiki set turns finished markdown wiki pages into a VitePress project. Dark theme, Mermaid diagrams rendered for dark mode, click-to-zoom on diagrams and images. CX Codex +1 ★ 3,232repo stars build-on-change davila7 build-on-change runs your build pipeline automatically whenever Claude Code edits a file. Detects build setups for Node.js, Make, Rust, and Java projects. 877installs unity-build-size gamedev-skills unity-build-size — a skill for Claude Code analyzes build reports, spots oversized textures, audio and glTFast models in Unity 6.3 LTS projects, and shrinks build size. CX Codex +1 1,800installs 5-build challengepost 5-build turns an approved plan into ordered working steps, then builds the app one step at a time with verification and a commit for each. Use it after planning or to resume an interrupted build. CX Codex +1 1,800installs build-acceleration mohitmishra786 build-acceleration — a Claude Code skill that teaches the agent how to cut C/C++ compile times. Kicks in on slow builds and walks through caching, distributed compilation, and link time fixes. CX Codex +1 597installs tailing-build-output spencerpauly tailing-build-output monitors build output in real time, catches errors as they stream, and patches source files before Webpack, Turbo, or Docker finishes. CX Codex +1 424installs epf-build Nikolay Shirokov epf-build builds a 1C external data processor into an EPF or ERF file from XML sources, checking modules before the build. CX Codex +1 47installs

From the same set36

The whole set →

Project sponsors

Companies that keep this analytics open