Skip to content
Back to search

claude-code-skill-factory

Claude Code Skill Factory — A powerful open-source toolkit for building and deploying production-ready Claude Skills, Code Agents, custom Slash Commands, and LLM Prompts at scale. Easily generate structured skill templates, automate workflow integration, and accelerate AI agent development with a clean, developer-friendly setup.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/alirezarezvani-claude-code-skill-factory/badge.svg)](/listings/alirezarezvani-claude-code-skill-factory)

HTML

<a href="/listings/alirezarezvani-claude-code-skill-factory"><img src="/api/listings/alirezarezvani-claude-code-skill-factory/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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]"

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 394 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Claude Code Skills & Agents Factory
  2. 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.
  3. ## 🚀 Quick Start (3 Shortcuts)
  4. ### Shortcut 1: Interactive Builder (Fastest)
  5. ```
  6. I want to build something
  7. ```
  8. The **factory-guide** agent asks what you need and delegates to specialist guides.
  9. ### Shortcut 2: Use Slash Commands
  10. ```bash
  11. /build skill # Interactive skill builder
  12. /build agent # Interactive agent builder
  13. /build prompt # Interactive prompt builder
  14. /build hook # Interactive hook builder
  15. ```
  16. ### Shortcut 3: Use Ready-Made Skills
  17. ```bash
  18. # Install Prompt Factory (69 professional presets)
  19. cp -r generated-skills/prompt-factory ~/.claude/skills/
  20. # Ask Claude
  21. "I need a prompt for [role name]"
  22. ```
  23. ---
  24. ## 📋 Built-in Commands
  25. This toolkit includes **10 slash commands** and **5 interactive agents** to streamline your workflow:
  26. ### Workflow Commands
  27. | Command | Purpose | Example |
  28. |---------|---------|---------|
  29. | `/build` | Interactive builder (skill/agent/prompt/hook) | `/build skill` or `/build hook` |
  30. | `/build-hook` | Build Claude Code hooks (Q&A, alias) | `/build-hook` |
  31. | `/validate-output` | Validate generated output + auto-ZIP | `/validate-output hook [path]` |
  32. | `/install-skill` | Install skills to Claude Code | `/install-skill [path]` |
  33. | `/install-hook` | Install hooks to settings | `/install-hook [path] [user\|project]` |
  34. | `/test-factory` | Run test examples | `/test-factory` |
  35. | `/factory-status` | Check system status (all factories) | `/factory-status` |
  36. | `/sync-agents-md` | Generate AGENTS.md from CLAUDE.md | `/sync-agents-md` |
  37. | `/codex-exec` | Execute Codex CLI commands | `/codex-exec analysis "task"` |
  38. | `/sync-todos-to-github` | Convert TodoWrite tasks to GitHub issues | `/sync-todos-to-github "Sprint 12"` |
  39. ### Interactive Guide Agents
  40. | Agent | Purpose | Activation |
  41. |-------|---------|-----------|
  42. | **factory-guide** | Orchestrator - delegates to specialists | "I want to build something" |
  43. | **skills-guide** | Build Claude Skills (4-5 questions) | "Build a skill" |
  44. | **prompts-guide** | Use Prompt Factory (69 presets) | "Generate a prompt" |
  45. | **agents-guide** | Build Claude Code Agents (5-6 questions) | "Create an agent" |
  46. | **hooks-guide** | Build Claude Code Hooks (5-7 questions) | "Build a hook" |
  47. See [.claude/agents/README.md](.claude/agents/README.md) and [.claude/commands/README.md](.claude/commands/README.md) for complete documentation.
  48. ---
  49. ## 🎯 Main Capabilities
  50. ### 1. Skills Factory
  51. Generate complete, production-ready Claude Skills with:
  52. - Properly formatted SKILL.md with YAML frontmatter
  53. - Python implementation files (when needed)
  54. - Sample input/output data
  55. - Complete documentation and usage guides
  56. - ZIP packages for easy distribution
  57. **Template**: [SKILLS_FACTORY_PROMPT.md](documentation/templates/SKILLS_FACTORY_PROMPT.md)
  58. **Shortcut**: `/build skill` or "I want to build a skill"
  59. ### 2. Agents Factory
  60. Create specialized Claude Code Agents with:
  61. - Enhanced YAML frontmatter (name, description, tools, model, color, field, expertise)
  62. - MCP integration support
  63. - Auto-invocation capabilities
  64. - Tool access configuration
  65. **Template**: [AGENTS_FACTORY_PROMPT.md](documentation/templates/AGENTS_FACTORY_PROMPT.md)
  66. **Shortcut**: `/build agent` or "I want to create an agent"
  67. ### 3. Prompt Factory
  68. Generate mega-prompts for any role with:
  69. - 69 professional presets across 15 domains
  70. - Multiple output formats (XML, Claude, ChatGPT, Gemini)
  71. - 7-point quality validation
  72. - Core & Advanced modes
  73. **Ready-to-use Skill**: [generated-skills/prompt-factory/](generated-skills/prompt-factory/)
  74. **Shortcut**: Install skill, then "I need a prompt for [role]"
  75. ### 4. Hooks Factory
  76. Generate Claude Code hooks for workflow automation with:
  77. - 7 event types (SessionStart, PostToolUse, SubagentStop, etc.)
  78. - Safety validation (tool detection, silent failure, no destructive ops)
  79. - Language-specific templates (Python/Black, JS/Prettier, Rust/rustfmt, Go/gofmt)
  80. - Interactive Q&A generation (5-7 questions)
  81. - Automatic security checks before installation
  82. **Template**: [HOOKS_FACTORY_PROMPT.md](documentation/templates/HOOKS_FACTORY_PROMPT.md)
  83. **Implementation**: [generated-skills/hook-factory/](generated-skills/hook-factory/)
  84. **Shortcut**: `/build hook` or "I want to build a hook"
  85. ### 5. Slash Command Factory
  86. Create custom slash commands with:
  87. - 17 preset commands (business, development, documentation, analysis)
  88. - Three official Anthropic patterns (Simple, Multi-Phase, Agent-Style)
  89. - Comprehensive 4-layer validation
  90. - Auto-generated bash permissions
  91. **Template**: [MASTER_SLASH_COMMANDS_PROMPT.md](documentation/templates/MASTER_SLASH_COMMANDS_PROMPT.md)
  92. **Shortcut**: Use template directly or `/build` with custom workflow
  93. ### 6. Codex CLI Bridge
  94. Enable Claude Code ↔ Codex CLI interoperability with:
  95. - Automatic CLAUDE.md → AGENTS.md translation
  96. - Reference-based architecture (no duplication)
  97. - Safety mechanisms and auto-validation
  98. - Cross-tool team collaboration support
  99. **Skill**: [generated-skills/codex-cli-bridge/](generated-skills/codex-cli-bridge/)
  100. **Shortcut**: `/sync-agents-md` to sync documentation
  101. ---
  102. ## 🔄 Complete Workflow Examples
  103. ### Example 1: Build a Skill in 2 Minutes
  104. ```bash
  105. # Step 1: Start builder
  106. /build skill
  107. # Step 2: Answer 4-5 questions
  108. # (Claude guides you through the process)
  109. # Step 3: Validate output
  110. /validate-output
  111. # Step 4: Install
  112. /install-skill
  113. # Done! Your skill is ready to use
  114. ```
  115. ### Example 2: Generate Cross-Platform Prompt
  116. ```bash
  117. # Step 1: Install Prompt Factory (one-time)
  118. cp -r generated-skills/prompt-factory ~/.claude/skills/
  119. # Step 2: Ask Claude
  120. "I need a prompt for a Senior DevOps Engineer"
  121. # Step 3: Answer 5-7 questions
  122. # (Select format: XML, Claude, ChatGPT, or Gemini)
  123. # Done! Copy and paste into your preferred LLM
  124. ```
  125. ### Example 3: Sync for Codex CLI Team
  126. ```bash
  127. # Step 1: Ensure CLAUDE.md exists in your project
  128. # (If missing, run /init first)
  129. # Step 2: Generate AGENTS.md for Codex CLI users
  130. /sync-agents-md
  131. # Step 3: Commit to repo
  132. git add AGENTS.md
  133. git commit -m "docs: Add AGENTS.md for Codex CLI compatibility"
  134. # Done! Codex CLI users can now reference your skills
  135. ```
  136. ---
  137. ## 📁 Repository Structure
  138. ```
  139. claude-code-skills-factory/
  140. ├── README.md # This file
  141. ├── CLAUDE.md # Repository guidance
  142. ├── AGENTS.md # Codex CLI documentation (auto-generated)
  143. ├── CHANGELOG.md # Version history
  144. ├── .claude/
  145. │ ├── agents/ # 5 interactive guide agents
  146. │ │ ├── factory-guide.md # Orchestrator
  147. │ │ ├── skills-guide.md # Skills builder
  148. │ │ ├── prompts-guide.md # Prompts generator
  149. │ │ ├── agents-guide.md # Agents creator
  150. │ │ └── hooks-guide.md # Hooks builder
  151. │ └── commands/ # 8 slash commands
  152. │ ├── build.md # Interactive builder
  153. │ ├── build-hook.md # Hook builder
  154. │ ├── validate-output.md # Validation + ZIP
  155. │ ├── install-skill.md # Installation guide
  156. │ ├── test-factory.md # Test runner
  157. │ ├── factory-status.md # Status checker
  158. │ ├── sync-agents-md.md # CLAUDE.md → AGENTS.md
  159. │ └── codex-exec.md # Codex CLI executor
  160. ├── claude-skills-examples/ # 3 reference implementations
  161. ├── documentation/
  162. │ ├── references/ # Official Anthropic examples
  163. │ └── templates/ # 4 factory prompt templates
  164. ├── generated-skills/ # 9 production-ready skills
  165. │ ├── aws-solution-architect/ # AWS architecture & IaC
  166. │ ├── content-trend-researcher/ # Multi-platform content research
  167. │ ├── ms365-tenant-manager/ # Microsoft 365 administration
  168. │ ├── agent-factory/ # Agent generation system
  169. │ ├── prompt-factory/ # Prompt generation powerhouse
  170. │ ├── slash-command-factory/ # Slash command generation
  171. │ ├── codex-cli-bridge/ # Claude Code ↔ Codex CLI bridge
  172. │ ├── hook-factory/ # Claude Code hooks automation
  173. │ └── claude-md-enhancer/ # CLAUDE.md generation & maintenance
  174. ├── generated-agents/ # Specialized agents
  175. │ └── claude-md-guardian/ # CLAUDE.md maintenance agent
  176. └── generated-commands/ # Custom slash commands
  177. └── enhance-claude-md/ # CLAUDE.md enhancement command
  178. ```
  179. ---
  180. ## 🎁 Production Skills Included
  181. All skills include complete implementation, documentation, samples, and distribution packages:
  182. ### 1. AWS Solution Architect (53 KB)
  183. Serverless architecture, IaC templates, cost optimization
  184. - [View Skill](generated-skills/aws-solution-architect/)
  185. ### 2. Content Trend Researcher (35 KB)
  186. Multi-platform trend analysis, SEO-optimized outlines
  187. - [View Skill](generated-skills/content-trend-researcher/)
  188. ### 3. Microsoft 365 Tenant Manager (40 KB)
  189. M365 administration, PowerShell automation
  190. - [View Skill](generated-skills/ms365-tenant-manager/)
  191. ### 4. Agent Factory (12 KB)
  192. Generate custom Claude Code agents with enhanced YAML
  193. - [View Skill](generated-skills/agent-factory/)
  194. ### 5. Prompt Factory (427 KB)
  195. 69 professional presets, multi-format output, 7-point validation
  196. - [View Skill](generated-skills/prompt-factory/)
  197. - **Most Popular** - Install first for instant productivity
  198. ### 6. Slash Command Factory (26 KB)
  199. 17 presets, official Anthropic patterns, 4-layer validation
  200. - [View Skill](generated-skills/slash-command-factory/)
  201. ### 7. Codex CLI Bridge (48 KB)
  202. Claude Code ↔ Codex CLI interoperability, AGENTS.md generation
  203. - [View Skill](generated-skills/codex-cli-bridge/)
  204. - Enables cross-tool team collaboration
  205. ### 8. Hook Factory v2.0 (92 KB) 🆕
  206. Build custom Claude Code hooks through interactive 7-question Q&A with automated installation and enhanced validation
  207. - [View Skill](generated-skills/hook-factory/)
  208. - **v2.0** - 10 production templates, automated installer (Python + Bash), secrets detection, event-specific validation
  209. ### 9. CLAUDE.md Enhancer (50 KB) 🆕
  210. Analyze, generate, and enhance CLAUDE.md files with 100% native format compliance, interactive initialization, and automatic maintenance
  211. - [View Skill](generated-skills/claude-md-enhancer/)
  212. - **Ecosystem**: Skill + Agent + Slash Command for complete CLAUDE.md lifecycle management
  213. - **Features**: Interactive workflow, quality scoring (0-100), modular architecture, 7 built-in examples
  214. - **Companion Agent**: [claude-md-guardian](generated-agents/claude-md-guardian/) - Background maintenance with auto-sync
  215. - **Slash Command**: `/enhance-claude-md` - Initialize or enhance CLAUDE.md files
  216. ---
  217. ## 💡 Reference Examples
  218. Three fully-functional example skills demonstrating different patterns:
  219. - **Analyzing Financial Statements** - Calculation engine + interpretation layer
  220. - **Creating Financial Models** - DCF valuation, sensitivity analysis, Monte Carlo simulation
  221. - **Applying Brand Guidelines** - Corporate branding application
  222. See [claude-skills-examples/](claude-skills-examples/) for implementation details.
  223. ---
  224. ## ✨ Key Features
  225. - **Production-Ready Output** - Proper YAML frontmatter, type-annotated Python, error handling
  226. - **Interactive Workflows** - Guided conversations through 4 specialist agents
  227. - **Built-in Automation** - 7 slash commands for common tasks
  228. - **Complete Packaging** - Documentation, samples, ZIP files included
  229. - **Smart Detection** - Automatically determines when Python code is needed vs prompt-only
  230. - **Multi-Format Support** - XML, Claude, ChatGPT, Gemini output formats
  231. - **Official Patterns** - Based on Anthropic documentation and examples
  232. - **Cross-Platform** - Works with Claude AI (desktop/browser), Claude Code, and API
  233. - **Cross-Tool Compatibility** - Bridge to OpenAI Codex CLI
  234. ---
  235. ## 📚 Documentation
  236. - **Skills Guide**: [documentation/references/claude-skills-instructions.md](documentation/references/claude-skills-instructions.md) - Complete Anthropic documentation
  237. - **Agents Guide**: [documentation/references/claude-agents-instructions.md](documentation/references/claude-agents-instructions.md) - Complete Anthropic documentation
  238. - **Codex CLI Reference**: [documentation/references/openai-codex-cli-instructions.md](documentation/references/openai-codex-cli-instructions.md) - Complete OpenAI Codex CLI documentation
  239. - **Slash Commands Examples**: [documentation/references/](documentation/references/) - Official Anthropic examples
  240. - **Factory Templates**: [documentation/templates/](documentation/templates/) - 4 generation templates
  241. - **Project Guide**: [CLAUDE.md](CLAUDE.md) - Repository structure and workflows
  242. - **Interactive Agents**: [.claude/agents/README.md](.claude/agents/README.md) - Guide agent documentation
  243. - **Slash Commands**: [.claude/commands/README.md](.claude/commands/README.md) - Command reference
  244. ---
  245. ## 🔗 Complementary Resources
  246. **Claude Code Tresor** - [alirezarezvani/claude-code-tresor](https://github.com/alirezarezvani/claude-code-tresor)
  247. - Ready-to-use development workflow tools (8 skills, 8 agents, 4 slash commands)
  248. - Immediate productivity gains with proven patterns
  249. - One-command installation
  250. **Claude Skills Library** - [alirezarezvani/claude-skills](https://github.com/alirezarezvani/claude-skills)
  251. - 37+ domain-specific production skills across 8 professional areas
  252. - Marketing, Product, Engineering, C-Level Advisory expertise
  253. - Battle-tested frameworks with proven ROI
  254. **How They Work Together**:
  255. - **This Factory**: Create custom skills/agents for unique requirements
  256. - **Tresor**: Deploy ready-made development workflow tools
  257. - **Skills Library**: Adopt domain-specific professional expertise
  258. ---
  259. ## 🌐 External Resources
  260. - **Anthropic Skills Docs**: https://docs.claude.com/en/docs/agents-and-tools/agent-skills/overview
  261. - **Skills Marketplace**: https://github.com/anthropics/skills
  262. - **Engineering Blog**: https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills
  263. - **API Documentation**: https://docs.claude.com/en/api/skills-guide
  264. ---
  265. ## 🤝 Contributing
  266. This is a reference repository. To contribute:
  267. 1. Fork the repository
  268. 2. Add new example skills to `claude-skills-examples/`
  269. 3. Ensure skills follow formatting standards
  270. 4. Include complete implementation with samples
  271. 5. Submit a pull request
  272. ---
  273. ## 📄 License
  274. This repository provides examples and templates for creating Claude Skills. The skills you generate using these templates are yours to use as you see fit.
  275. ---
  276. ## 📊 Version
  277. **Current Version**: 1.4.0
  278. **Last Updated**: October 30, 2025
  279. **Compatible With**: Claude Skills (all platforms), Claude Code Agents, Claude Code Slash Commands
  280. **Latest Changes** (v1.4.0):
  281. - ✨ Added **Codex CLI Bridge** skill for Claude Code ↔ OpenAI Codex CLI interoperability
  282. - ✨ Added `/sync-agents-md` and `/codex-exec` slash commands
  283. - ✨ AGENTS.md auto-generation capability for cross-tool compatibility
  284. - 📝 Consolidated README.md for better focus on main capabilities and shortcuts
  285. - 🚀 Enhanced Quick Start with 3 shortcuts and workflow examples
  286. **Previous Changes** (v1.3.0):
  287. - MASTER_SLASH_COMMANDS_PROMPT.md template with official Anthropic patterns
  288. - Slash Command Factory v2.0 with 17 presets and 4-layer validation
  289. - Three official command patterns (Simple, Multi-Phase, Agent-Style)
  290. **Previous Changes** (v1.2.0):
  291. - Prompt Factory skill with 69 presets across 15 domains
  292. - Multi-format output (XML/Claude/ChatGPT/Gemini)
  293. - 7-point quality validation system
  294. **See**: [CHANGELOG.md](CHANGELOG.md) for complete version history
  295. ---
  296. ## 📈 Star History
  297. [![Star History Chart](https://api.star-history.com/svg?repos=alirezarezvani/claude-code-skill-factory&type=date&legend=bottom-right)](https://star-history.com/#alirezarezvani/claude-code-skill-factory&Date)
  298. ---
  299. **Ready to build?** Try one of the shortcuts above, or explore the [factory templates](documentation/templates/) to start generating production-ready skills, agents, prompts, or slash commands!

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.