agent-factory

Claude Code Skills & Agents Factory

A comprehensive toolkit for generating production-ready Claude Skills and Claude Code Agents at scale. This repository provides templates, examples, and powerful prompt engineering systems to create custom skills and specialized agents for Claude AI across all platforms.

🚀 Quick Start (3 Shortcuts)

Shortcut 1: Interactive Builder (Fastest)

I want to build something

The factory-guide agent asks what you need and delegates to specialist guides.

Shortcut 2: Use Slash Commands

/build skill              # Interactive skill builder
/build agent              # Interactive agent builder
/build prompt             # Interactive prompt builder
/build hook               # Interactive hook builder

Shortcut 3: Use Ready-Made Skills

# Install Prompt Factory (69 professional presets)
cp -r generated-skills/prompt-factory ~/.claude/skills/

# Ask Claude
"I need a prompt for [role name]"

---

📋 Built-in Commands

This toolkit includes 10 slash commands and 5 interactive agents to streamline your workflow:

Workflow Commands

Interactive Guide Agents

See .claude/agents/README.md and .claude/commands/README.md for complete documentation.

---

🎯 Main Capabilities

1. Skills Factory

Generate complete, production-ready Claude Skills with:

• Properly formatted SKILL.md with YAML frontmatter
• Python implementation files (when needed)
• Sample input/output data
• Complete documentation and usage guides
• ZIP packages for easy distribution

Template: SKILLS_FACTORY_PROMPT.md Shortcut: /build skill or "I want to build a skill"

2. Agents Factory

Create specialized Claude Code Agents with:

• Enhanced YAML frontmatter (name, description, tools, model, color, field, expertise)
• MCP integration support
• Auto-invocation capabilities
• Tool access configuration

Template: AGENTS_FACTORY_PROMPT.md Shortcut: /build agent or "I want to create an agent"

3. Prompt Factory

Generate mega-prompts for any role with:

• 69 professional presets across 15 domains
• Multiple output formats (XML, Claude, ChatGPT, Gemini)
• 7-point quality validation
• Core & Advanced modes

Ready-to-use Skill: generated-skills/prompt-factory/ Shortcut: Install skill, then "I need a prompt for [role]"

4. Hooks Factory

Generate Claude Code hooks for workflow automation with:

• 7 event types (SessionStart, PostToolUse, SubagentStop, etc.)
• Safety validation (tool detection, silent failure, no destructive ops)
• Language-specific templates (Python/Black, JS/Prettier, Rust/rustfmt, Go/gofmt)
• Interactive Q&A generation (5-7 questions)
• Automatic security checks before installation

Template: HOOKS_FACTORY_PROMPT.md Implementation: generated-skills/hook-factory/ Shortcut: /build hook or "I want to build a hook"

5. Slash Command Factory

Create custom slash commands with:

• 17 preset commands (business, development, documentation, analysis)
• Three official Anthropic patterns (Simple, Multi-Phase, Agent-Style)
• Comprehensive 4-layer validation
• Auto-generated bash permissions

Template: MASTER_SLASH_COMMANDS_PROMPT.md Shortcut: Use template directly or /build with custom workflow

6. Codex CLI Bridge

Enable Claude Code ↔ Codex CLI interoperability with:

• Automatic CLAUDE.md → AGENTS.md translation
• Reference-based architecture (no duplication)
• Safety mechanisms and auto-validation
• Cross-tool team collaboration support

Skill: generated-skills/codex-cli-bridge/ Shortcut: /sync-agents-md to sync documentation

---

🔄 Complete Workflow Examples

Example 1: Build a Skill in 2 Minutes

# Step 1: Start builder
/build skill

# Step 2: Answer 4-5 questions
# (Claude guides you through the process)

# Step 3: Validate output
/validate-output

# Step 4: Install
/install-skill

# Done! Your skill is ready to use

Example 2: Generate Cross-Platform Prompt

# Step 1: Install Prompt Factory (one-time)
cp -r generated-skills/prompt-factory ~/.claude/skills/

# Step 2: Ask Claude
"I need a prompt for a Senior DevOps Engineer"

# Step 3: Answer 5-7 questions
# (Select format: XML, Claude, ChatGPT, or Gemini)

# Done! Copy and paste into your preferred LLM

Example 3: Sync for Codex CLI Team

# Step 1: Ensure CLAUDE.md exists in your project
# (If missing, run /init first)

# Step 2: Generate AGENTS.md for Codex CLI users
/sync-agents-md

# Step 3: Commit to repo
git add AGENTS.md
git commit -m "docs: Add AGENTS.md for Codex CLI compatibility"

# Done! Codex CLI users can now reference your skills

---

📁 Repository Structure

claude-code-skills-factory/
├── README.md                              # This file
├── CLAUDE.md                              # Repository guidance
├── AGENTS.md                              # Codex CLI documentation (auto-generated)
├── CHANGELOG.md                           # Version history
├── .claude/
│   ├── agents/                            # 5 interactive guide agents
│   │   ├── factory-guide.md              # Orchestrator
│   │   ├── skills-guide.md               # Skills builder
│   │   ├── prompts-guide.md              # Prompts generator
│   │   ├── agents-guide.md               # Agents creator
│   │   └── hooks-guide.md                # Hooks builder
│   └── commands/                          # 8 slash commands
│       ├── build.md                       # Interactive builder
│       ├── build-hook.md                  # Hook builder
│       ├── validate-output.md             # Validation + ZIP
│       ├── install-skill.md               # Installation guide
│       ├── test-factory.md                # Test runner
│       ├── factory-status.md              # Status checker
│       ├── sync-agents-md.md              # CLAUDE.md → AGENTS.md
│       └── codex-exec.md                  # Codex CLI executor
├── claude-skills-examples/                # 3 reference implementations
├── documentation/
│   ├── references/                        # Official Anthropic examples
│   └── templates/                         # 4 factory prompt templates
├── generated-skills/                      # 9 production-ready skills
│