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

| Command | Purpose | Example | |---------|---------|---------| | /build | Interactive builder (skill/agent/prompt/hook) | /build skill or /build hook | | /build-hook | Build Claude Code hooks (Q&A, alias) | /build-hook | | /validate-output | Validate generated output + auto-ZIP | /validate-output hook [path] | | /install-skill | Install skills to Claude Code | /install-skill [path] | | /install-hook | Install hooks to settings | /install-hook [path] [user\|project] | | /test-factory | Run test examples | /test-factory | | /factory-status | Check system status (all factories) | /factory-status | | /sync-agents-md | Generate AGENTS.md from CLAUDE.md | /sync-agents-md | | /codex-exec | Execute Codex CLI commands | /codex-exec analysis "task" | | /sync-todos-to-github | Convert TodoWrite tasks to GitHub issues | /sync-todos-to-github "Sprint 12" |

Interactive Guide Agents

| Agent | Purpose | Activation | |-------|---------|-----------| | factory-guide | Orchestrator - delegates to specialists | "I want to build something" | | skills-guide | Build Claude Skills (4-5 questions) | "Build a skill" | | prompts-guide | Use Prompt Factory (69 presets) | "Generate a prompt" | | agents-guide | Build Claude Code Agents (5-6 questions) | "Create an agent" | | hooks-guide | Build Claude Code Hooks (5-7 questions) | "Build a hook" |

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
│   ├── aws-solution-architect/            # AWS architecture & IaC
│   ├── content-trend-researcher/          # Multi-platform content research
│   ├── ms365-tenant-manager/              # Microsoft 365 administration
│   ├── agent-factory/                     # Agent generation system
│   ├── prompt-factory/                    # Prompt generation powerhouse
│   ├── slash-command-factory/             # Slash command generation
│   ├── codex-cli-bridge/                  # Claude Code ↔ Codex CLI bridge
│   ├── hook-factory/                      # Claude Code hooks automation
│   └── claude-md-enhancer/                # CLAUDE.md generation & maintenance
├── generated-agents/                      # Specialized agents
│   └── claude-md-guardian/                # CLAUDE.md maintenance agent
└── generated-commands/                    # Custom slash commands
    └── enhance-claude-md/                 # CLAUDE.md enhancement command

---

🎁 Production Skills Included

All skills include complete implementation, documentation, samples, and distribution packages:

1. AWS Solution Architect (53 KB)

Serverless architecture, IaC templates, cost optimization

• View Skill

2. Content Trend Researcher (35 KB)

Multi-platform trend analysis, SEO-optimized outlines

• View Skill

3. Microsoft 365 Tenant Manager (40 KB)

M365 administration, PowerShell automation

• View Skill

4. Agent Factory (12 KB)

Generate custom Claude Code agents with enhanced YAML

• View Skill

5. Prompt Factory (427 KB)

69 professional presets, multi-format output, 7-point validation

• View Skill
• Most Popular - Install first for instant productivity

6. Slash Command Factory (26 KB)

17 presets, official Anthropic patterns, 4-layer validation

• [View Skill](generated-skills/