A comprehensive toolkit for generating production-ready Claude Skills and Claude Code Agents at scale. This repository provides templates, examples, powerful prompt engineering systems, and interactive navigation agents to create custom skills and specialized agents for Claude AI across all platforms (Claude apps, Claude Code, and API).
Use the built-in guide agents for step-by-step assistance:
I want to build something
→ factory-guide orchestrator asks what you want to build (Skill, Prompt, or Agent) → Delegates to specialist: skills-guide, prompts-guide, or agents-guide → Specialist asks 3-6 straightforward questions → Complete output generated, validated, and ready to use
Learn more: .claude/agents/README.md
- What Are Claude Skills?
- What Are Claude Code Agents?
- Repository Contents
- Quick Start
- Example Skills Included
- Generated Skills
- Key Features
- Skill Architecture Patterns
- Best Practices
- Customization Guide
- YAML Frontmatter Rules
- Technical Details
- Resources
- Public Gists (SEO & AEO)
- Complementary Resources
- Real-World Examples
- Contributing
- License
- Version
- Quick Reference
Claude Skills are specialized capabilities that teach Claude how to perform specific tasks. They're packaged as folders containing:
- SKILL.md: Structured instructions with YAML frontmatter
- Python files (optional): Functional code for calculations, data processing, or file generation
- Sample data: JSON examples showing inputs and expected outputs
- Usage guide: Clear invocation examples
Skills are composable (work together), portable (same format everywhere), and efficient (loaded only when relevant).
Claude Code Agents (also called sub-agents) are specialized AI assistants that handle specific types of tasks. They're single Markdown files with YAML frontmatter containing:
- Enhanced YAML frontmatter: name, description, tools, model, color, field, expertise, MCP integrations
- System prompt: Detailed instructions for the agent's behavior and approach
- Auto-invocation: Claude automatically uses them when the description matches the task
Agents are focused (one responsibility), efficient (separate context window), flexible (configurable tool access), and composable (multiple agents work together on complex workflows).
Key Difference:
- Skills = Multi-file capabilities (folders with SKILL.md + Python + samples)
- Agents = Single-file specialists (.md files in
.claude/agents/)
claude-code-skills-factory/
├── README.md # This file
├── CLAUDE.md # Repository guidance for Claude Code
├── claude-skills-instructions.md # Full Skills documentation from Anthropic
├── claude-agents-instructions.md # Full Agents documentation from Anthropic
├── claude-skills-examples/ # Reference skill implementations
│ ├── analyzing_financial_statements.md
│ ├── calculate_ratios.py
│ ├── interpret_ratios.py
│ ├── creating-financial-models.md
│ ├── dcf_model.py
│ ├── sensitivity_analysis.py
│ ├── brand_guidelines.md
│ └── apply_brand.py
├── generated-skills/ # Production-ready generated skills
│ ├── aws-solution-architect/ # AWS architecture (53 KB)
│ ├── content-trend-researcher/ # Multi-platform content research (35 KB)
│ ├── ms365-tenant-manager/ # Microsoft 365 administration (40 KB)
│ ├── psychology-advisor/ # Mental wellness & CBT techniques (31 KB)
│ ├── agent-factory/ # Claude Code agent generation (12 KB)
│ └── prompt-factory/ # Prompt generation powerhouse (427 KB)
└── documentation/
└── templates/
├── SKILLS_FACTORY_PROMPT.md # Template for generating Skills
└── AGENTS_FACTORY_PROMPT.md # Template for generating Agents
Open documentation/templates/SKILLS_FACTORY_PROMPT.md and scroll to the bottom.
Fill in the template variables:
=== FILL IN YOUR DETAILS BELOW ===
BUSINESS_TYPE: SaaS startup (project management tool)
USE_CASES: Analyze user feedback sentiment, Generate feature prioritization reports, Create customer success playbooks
NUMBER_OF_SKILLS: 3
ADDITIONAL_CONTEXT: Use data-driven decision making, modern tech stack
Copy the entire prompt (including your filled variables) and paste it into:
- Claude.ai (any plan with Skills enabled)
- Claude Code
- Claude API (with Code Execution Tool)
Claude will generate complete skill packages with:
- ✅ Properly formatted SKILL.md files (kebab-case names in YAML)
- ✅ Python implementation files (when functional code is needed)
- ✅ Sample input/output JSON files
- ✅ HOW_TO_USE.md with invocation examples
- ✅ ZIP files ready for import into Claude AI desktop
Claude AI Desktop:
- Import the generated
.zipfiles directly through the Skills menu
Claude Code:
- Copy skill folders to
~/.claude/skills/
Claude Apps (Browser):
- Use the "skill-creator" skill to import
API:
- Use the
/v1/skillsendpoint to upload
Open documentation/templates/AGENTS_FACTORY_PROMPT.md and scroll to the bottom.
Fill in the template variables:
=== FILL IN YOUR DETAILS BELOW ===
AGENT_NAME: api-integration-specialist
AGENT_TYPE: Implementation
DOMAIN_FIELD: backend
DESCRIPTION: API integration expert. Use when building API clients.
TOOLS_NEEDED: Read, Write, Edit, Bash
MODEL: sonnet
COLOR: green
EXPERTISE_LEVEL: expert
MCP_TOOLS: mcp__github
Copy the entire prompt and paste into Claude. You'll get a complete agent .md file:
---
name: api-integration-specialist
description: API integration expert...
tools: Read, Write, Edit, Bash
model: sonnet
color: green
field: backend
expertise: expert
mcp_tools: mcp__github
---
System prompt with detailed instructions...Project-level (shared with team):
cp api-integration-specialist.md .claude/agents/User-level (available everywhere):
cp api-integration-specialist.md ~/.claude/agents/Agent auto-invokes when Claude detects relevant tasks!
The Prompt Factory is a ready-to-use skill (not a template) that generates world-class mega-prompts for any role, industry, and task.
Install the skill:
# Copy to your skills directory
cp -r generated-skills/prompt-factory ~/.claude/skills/
# Or import the ZIP in Claude Desktop
# File: generated-skills/prompt-factory.zip (403 KB)Interactive Mode (Recommended):
I need a prompt for a Senior Full-Stack Engineer
Claude will ask 5-7 questions and generate a complete mega-prompt.
Custom Mode:
Create a custom prompt for [your specific role/need]
Answer the intelligent question flow (max 7 questions) and select:
- Format: XML, Claude, ChatGPT, Gemini, or All
- Mode: Core (~5K tokens) or Advanced (~12K tokens with testing scenarios)
Copy the generated prompt and use it in:
- Claude AI: Paste at start of conversation
- ChatGPT: Use Custom Instructions feature
- Gemini: Paste as system configuration
- Any LLM: Universal XML format
Features:
- ✅ 69 quick-start presets across 15 professional domains
- ✅ Technical (8), Business (8), Legal (4), Finance (4), HR (4), Design (4), Customer (4), Executive (7), Specialized-Technical (6), Research (3), Creative-Media (4), Manufacturing (4), R&D (2), Regulatory (1), Specialized (3)
- ✅ Multiple output formats (XML/Claude/ChatGPT/Gemini)
- ✅ 7-point quality validation before delivery
- ✅ Contextual best practices from OpenAI, Anthropic, Google
- ✅ Core & Advanced modes (with testing scenarios and variations)
- ✅ Token count optimization and reporting
Pattern: 7-question flow → preset matching → template synthesis → quality validation → multi-format output
See: generated-skills/prompt-factory/ for complete documentation
This repository includes three fully-functional example skills:
Purpose: Calculate and interpret financial ratios (ROE, ROA, liquidity, leverage, etc.)
Files:
Pattern: Calculation engine + interpretation layer
Purpose: DCF valuation, Monte Carlo simulation, sensitivity analysis
Files:
Pattern: Historical data → projections → valuation
Purpose: Apply consistent corporate branding to documents
Files:
Pattern: Brand definition + application logic
This repository also includes production-ready skills generated using the Skills Factory Prompt, demonstrating the quality and completeness of output you can expect.
Purpose: Expert AWS architecture design for startups - serverless, scalable, and cost-effective cloud infrastructure
Files:
Capabilities:
- Serverless architecture design (Lambda, API Gateway, DynamoDB, EventBridge)
- Infrastructure as Code (CloudFormation, CDK, Terraform)
- Cost optimization and budget management
- Security best practices and compliance
- CI/CD pipeline setup
- Multi-region deployment strategies
Pattern: Architecture design → IaC templates → cost optimization
Purpose: Advanced content research analyzing trends across 10+ platforms to generate data-driven article outlines
Files:
Capabilities:
- Multi-platform trend analysis (Google Trends, Reddit, YouTube, Medium, Substack, LinkedIn, X, etc.)
- User intent analysis (informational, commercial, transactional)
- Content gap identification
- SEO-optimized article outline generation
- Platform-specific best practices and publishing strategies
Pattern: Trend analysis → intent analysis → content gap discovery → outline generation
Purpose: Comprehensive M365 tenant administration for setup, security, user management, and organizational optimization
Files:
Capabilities:
- Tenant setup and configuration
- User and group lifecycle management
- Security and compliance policies (Conditional Access, MFA, DLP)
- SharePoint, OneDrive, and Teams administration
- Exchange Online management
- PowerShell automation script generation
- License management and cost optimization
Pattern: Configuration requirements → PowerShell scripts → validation checklists
Purpose: World-class prompt powerhouse for generating production-ready mega-prompts for any role, industry, and task
Files:
Capabilities:
- 69 comprehensive presets across 15 professional domains
- Intelligent 7-question flow for requirement gathering
- Multiple output formats (XML/Claude/ChatGPT/Gemini)
- 7-point quality validation before delivery
- Contextual best practices from OpenAI, Anthropic, Google
- Core & Advanced modes with testing scenarios
- Complete coverage: Technical (8), Business (8), Legal (4), Finance (4), HR (4), Design (4), Customer (4), Executive (7), Specialized-Technical (6), Research (3), Creative-Media (4), Manufacturing (4), R&D (2), Regulatory (1), Specialized (3)
Pattern: 7-question flow → preset selection → quality validation → multi-format output
Every generated skill follows enterprise standards:
- Proper YAML frontmatter with kebab-case names
- Type-annotated Python with error handling
- Safe operations (division by zero, missing data)
- Minimal, focused sample data
Skills are designed to work together:
data-extractor→data-analyzer→report-generator→brand-formatter- No duplicate functionality
- Clear input/output contracts
Each skill includes everything needed:
- SKILL.md with structured documentation
- Python files (multi-file when needed)
- sample_input.json and expected_output.json
- HOW_TO_USE.md with invocation examples
- .zip file containing entire skill folder
The prompt automatically determines:
- When Python code is needed vs. prompt-only
- Multi-file structure for complex skills
- Appropriate sample data formats
For instructional or template-based tasks:
- Style guides and tone of voice
- Decision frameworks
- Content guidelines
- Brand voice standards
No Python needed - just structured instructions in SKILL.md
For computation, processing, or generation:
- Financial calculations
- Data analysis and transformation
- File generation (Excel, PDF, etc.)
- API interactions
Python files included - class-based, type-annotated, with safe operations
For complex functionality:
calculate_*.py- Core computationsinterpret_*.py- Analysis and insightsformat_*.py- Output formattingvalidate_*.py- Input validation
- Keep skills focused - One clear purpose per skill
- Make them composable - Output of one skill feeds another
- Validate inputs - Handle missing or invalid data gracefully
- Use kebab-case - For YAML name fields and folder names
- Provide context - Industry-specific considerations in documentation
- Include examples - Clear invocation patterns in HOW_TO_USE.md
- Match to task - Use the skill that fits your specific need
- Provide complete data - Skills work best with full input data
- Check outputs - Validate results against your requirements
- Combine skills - Chain multiple skills for complex workflows
To customize the included examples:
- Update YAML frontmatter - Change
nameanddescriptionto match your use case - Modify constants - Replace Acme Corporation branding with yours
- Adjust calculations - Modify formulas for your industry
- Extend functionality - Add new methods to existing classes
- Simplify - Remove features you don't need
Use the Skills Factory Prompt with your specific:
- Business type and industry
- Specific use cases and tasks
- Number of skills needed
- Technical requirements and constraints
CRITICAL: Every SKILL.md must start with properly formatted YAML:
---
name: skill-name-in-kebab-case
description: Brief one-line description of what this skill does
---Correct:
---
name: financial-ratios
description: Calculates key financial ratios from financial statement data
---Incorrect:
---
name: Financial Ratios ❌ Title Case
name: financial_ratios ❌ snake_case
name: financialRatios ❌ camelCase
---All Python files follow these conventions:
- Type hints for all functions and classes
- Docstrings with Args and Returns sections
- Safe operations (e.g.,
safe_divideto avoid division by zero) - Class-based structure for stateful operations
- Modular design with separation of concerns
- Folders:
skill-name/(kebab-case) - YAML name:
name: skill-name(kebab-case) - Python files:
calculate_metrics.py(snake_case - Python convention) - ZIP files:
skill-name.zip(kebab-case)
Keep sample files minimal and focused:
- sample_input.json: Just enough data to test the skill
- expected_output.json: Clear structure showing what skill produces
- Use realistic but simple values
- Include all required fields
- Anthropic Skills Documentation: https://docs.claude.com/en/docs/agents-and-tools/agent-skills/overview
- Skills Marketplace: https://github.com/anthropics/skills
- Engineering Blog: https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills
- Claude Help Center: https://support.claude.com/en/articles/12512176-what-are-skills
- API Documentation: https://docs.claude.com/en/api/skills-guide
Comprehensive guides published as GitHub Gists for improved visibility, SEO rankings, and Answer Engine Optimization (AEO) for ChatGPT, Perplexity, Claude, and other AI search engines.
Gist: health-sdk-builder-healthcare-ai-claude-agent.md
Comprehensive guide for building HIPAA/GDPR/DSGVO-compliant healthcare applications with multilingual support (German + English), all therapy modalities (CBT, Psychodynamic, Psychoanalysis, Depth Psychology), German PTV 10 automation, and 2025 Claude API features.
Keywords: Healthcare AI, HIPAA compliance, GDPR, Mental health apps, Psychotherapy software, German PTV 10, Medical AI, Patient empowerment
Gist: claude-skills-agents-factory-complete-guide.md
Overview of the entire factory system for generating Claude Skills, Claude Code Agents, and production-ready prompts. Includes all 6 production skills, healthcare specialization, and 2025 API features.
Keywords: Claude Skills, Claude Agents, Agent SDK, AI Automation, Healthcare AI, Multilingual AI, 2025 Claude API
Gist: prompt-factory-ai-prompt-generation-tool.md
World-class prompt generation with 69 professional presets across 15 domains, multi-format output (XML/Claude/ChatGPT/Gemini), and 7-point quality validation.
Keywords: Prompt Engineering, AI Prompts, ChatGPT Custom Instructions, Claude Prompts, Gemini Prompts, Multi-LLM Support
See: GISTS.md for complete SEO/AEO strategy and update guidelines.
Looking for ready-to-use Claude augmentation tools? These companion repositories provide battle-tested implementations that complement the factories in this project:
Repository: alirezarezvani/claude-code-tresor
A comprehensive collection of professional-grade utilities that supercharge your Claude Code development workflow. While this factory helps you create custom skills and agents, Claude Code Tresor provides ready-to-use implementations you can install immediately.
What It Includes:
- 8 Autonomous Skills (v2.0): Background helpers for code quality, testing, git commits, security auditing, documentation maintenance
- 8 Specialized Agents: Expert sub-agents for code review, system architecture, debugging, performance optimization, refactoring
- 4 Slash Commands:
/scaffold,/review,/test-gen,/docs-genfor rapid workflow automation - 20+ Prompt Templates: Curated prompts for common development tasks
- 5 Development Standards: Style guides and best practices
- 200+ Components: Additional utilities in source library
Installation: One-command setup via ./scripts/install.sh (completes in under 2 minutes)
Perfect For: Developers who want immediate productivity gains with proven patterns for code quality, testing, documentation, and architecture.
Repository: alirezarezvani/claude-skills
A production-ready library of 37+ domain-specific skills across 8 professional areas. While this factory provides templates for creating skills, the Skills Library offers complete, specialized implementations for specific business functions.
What It Provides:
- 37+ Production Skills: Marketing (3), C-Level Advisory (2), Product Teams (5), Project Management (6), Engineering (9), and more
- Domain Expertise Packages: Each skill includes comprehensive documentation, Python analysis tools (CLI-based, no API dependencies), knowledge bases, and ready-to-use templates
- Proven Results: 40%+ time savings, 30%+ quality improvements through battle-tested frameworks
Skill Categories:
- Marketing: Content creation, demand generation, product marketing strategy
- C-Level Advisory: CEO and CTO strategic guidance
- Product Teams: PM toolkit, agile practices, UX research, design systems
- Project Management: Senior PM, Scrum mastery, Atlassian (Jira/Confluence) expertise
- Engineering: Architecture, frontend/backend, fullstack, QA, DevOps, security, code review
Perfect For: Teams and professionals seeking domain-specific expertise in marketing, product management, engineering, or business leadership with immediate deployment and no external API dependencies.
This Factory (claude-code-skills-factory):
- ✨ Create custom skills and agents tailored to your specific needs
- 🏗️ Templates and generation systems for building from scratch
- 📖 Learning resource with detailed examples and patterns
Claude Code Tresor:
- ⚡ Deploy ready-made development workflow tools immediately
- 🛠️ Pre-built agents, commands, and automation for daily coding tasks
- 🎯 Focus on code quality, testing, and documentation automation
Claude Skills Library:
- 🎓 Adopt domain-specific professional expertise instantly
- 📦 Complete skill packages for specific business functions
- 💼 Battle-tested frameworks for marketing, product, engineering, and leadership
Recommended Workflow:
- Start with Claude Code Tresor for immediate development productivity
- Browse Claude Skills Library for domain-specific capabilities you need
- Use this Factory to generate custom skills for unique requirements not covered by the other repositories
All three repositories work seamlessly with Claude AI and Claude Code across all platforms (desktop, browser, CLI, API).
Track the growth and adoption of the Claude Code ecosystem:
Legend:
- 🔵 claude-code-skills-factory - This repository (Skills & Agents Factory)
- 🟢 claude-code-tresor - Development workflow utilities
- 🟠 claude-skills - Domain-specific skill library
The generated-skills/ folder contains actual production-ready skills created using the Skills Factory Prompt:
Generated for startup infrastructure needs - includes architecture design, cost optimization, and IaC templates.
See: generated-skills/aws-solution-architect/
Generated for content creators and marketers - analyzes trends across 10+ platforms and creates data-driven outlines.
See: generated-skills/content-trend-researcher/
Generated for IT administrators - manages M365 tenant setup, security, and generates PowerShell automation scripts.
See: generated-skills/ms365-tenant-manager/
Evidence-based mental wellness skill with CBT techniques, mindfulness exercises, stress management, and emotional regulation tools.
Key Features: 10 cognitive distortion types, 4 breathing techniques, RAIN method, stress assessment, behavioral activation
See: generated-skills/psychology-advisor/
Multi-platform content research analyzing trends across Google, Reddit, YouTube, Medium, LinkedIn, X, Substack, and more to generate data-driven article outlines.
Key Features: User intent analysis, content gap discovery, platform-specific strategies, SEO-optimized outlines
See: generated-skills/content-trend-researcher/
Claude Code agent generation system that creates custom agents/sub-agents with enhanced YAML frontmatter, tool patterns, and MCP integration.
Key Features: Enhanced YAML (color, field, expertise), tool access patterns, execution safety, MCP tool suggestions
See: generated-skills/agent-factory/ Template: documentation/templates/AGENTS_FACTORY_PROMPT.md
World-class prompt powerhouse that generates production-ready mega-prompts for any role, industry, and task through intelligent 7-question flow.
Key Features: 69 comprehensive presets across 15 professional domains (Technical, Business, Legal, Finance, HR, Design, Customer, Executive, Manufacturing, R&D, Regulatory, Specialized-Technical, Research, Creative-Media), multiple output formats (XML/Claude/ChatGPT/Gemini), 7-point quality validation gates, contextual best practices from OpenAI/Anthropic/Google
Domains Covered: Full-Stack Engineer, DevOps, Product Manager, Legal Counsel, CFO, HR Manager, UI/UX Designer, Customer Success, CEO, ML Engineer, Research Scientist, Copywriter, Manufacturing Engineer, Clinical Specialist, and 55+ more roles
See: generated-skills/prompt-factory/
Each includes full implementation, sample data, HOW_TO_USE guide, and ready-to-import ZIP files.
This is a reference repository. To contribute:
- Fork the repository
- Add new example skills to
claude-skills-examples/ - Ensure skills follow all formatting standards
- Include complete implementation with samples
- Submit a pull request
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.
Current Version: 1.2.0 Last Updated: October 23, 2025 Compatible With: Claude Skills (all platforms) and Claude Code Agents
Latest Changes (v1.2.0):
- Added Prompt Factory skill (427 KB) - World-class prompt generation with 69 presets across 15 domains
- Expanded coverage: Technical, Business, Legal, Finance, HR, Design, Customer, Executive, Manufacturing, R&D, Regulatory, Specialized-Technical, Research, Creative-Media domains
- Multi-format output support (XML/Claude/ChatGPT/Gemini)
Create Skills: Use SKILLS_FACTORY_PROMPT.md Create Agents: Use AGENTS_FACTORY_PROMPT.md Create Prompt Builders: Use PROMPTS_FACTORY_PROMPT.md See Examples: Check claude-skills-examples/ Generated Skills: Explore generated-skills/ Read Guide: See CLAUDE.md for repository structure Learn More (Skills): Read claude-skills-instructions.md Learn More (Agents): Read claude-agents-instructions.md
Ready to build? Open a prompt template, fill in your details, and start generating production-ready skills, agents or master prompts for your Claude Code project!