Contributing to Claude Code Skills & Agents Factory

Contributing to Claude Code Skills & Agents Factory

Thank you for your interest in contributing! This repository provides templates and examples for generating Claude Skills and Claude Code Agents.

---

🎯 Types of Contributions

1. New Example Skills

Add new skill examples to `claude-skills-examples/` (reference implementations only, not production skills).

2. Generated Skills

Share production-ready skills you've created using the factory templates.

3. Documentation Improvements

• Clarify existing documentation
• Add troubleshooting guides
• Improve setup instructions
• Translate documentation

4. Template Enhancements

• Improve SKILLS_FACTORY_PROMPT.md
• Enhance AGENTS_FACTORY_PROMPT.md
• Add PROMPTS_FACTORY_PROMPT.md examples

5. Bug Reports

Report issues with templates, examples, or documentation.

---

📋 Contribution Guidelines

Before Contributing

1. Search existing issues to avoid duplicates
2. Check if the contribution fits the repository's scope
3. Read the documentation (README, CLAUDE.md, GISTS.md)

Code Standards

**Python**:

• Type hints for all functions
• Docstrings (Google style)
• PEP 8 compliance
• Error handling for edge cases

• 80% test coverage

**YAML Frontmatter**:

• Use kebab-case for skill names
• Clear, concise descriptions
• No reserved words ("claude" prohibited in skill names)

**Markdown**:

• Clear headings (H1, H2, H3)
• Code blocks with syntax highlighting
• Examples for complex concepts
• Links to related documentation

Documentation Standards

• User-facing: Clear, actionable, beginner-friendly
• Technical: Comprehensive, with code examples
• Bilingual (if healthcare): German + English
• Reading level: Appropriate for audience

---

🚀 How to Contribute

Contributing Skills or Agents

1. Fork the repository
2. Create your skill/agent using factory templates
3. Test thoroughly - ensure it works as documented
4. Document completely:
   • SKILL.md with proper YAML frontmatter
   • HOW_TO_USE.md with clear examples
   • Sample input/output (if applicable)
   • Python implementation (if needed)
5. Submit pull request with:
   • Clear title describing the skill
   • Description of what it does
   • Usage examples
   • Testing evidence

Contributing Documentation

1. Fork the repository
2. Make improvements:
   • Fix typos or unclear sections
   • Add missing information
   • Improve examples
   • Translate content
3. Test links and code examples
4. Submit pull request with:
   • Clear description of changes
   • Why the change improves documentation

Contributing Bug Fixes

1. Create issue describing the bug
2. Fork and fix in a feature branch
3. Test the fix thoroughly
4. Submit pull request with:
   • Reference to issue: "Fixes #123"
   • Description of fix
   • Test evidence

---

🏗️ Development Process

Setting Up Development Environment

# Clone your fork
git