Contributing to Claude Code Skills Marketplace

Contributing to Claude Code Skills Marketplace

Thank you for your interest in contributing! This marketplace aims to provide high-quality, production-ready skills for Claude Code users.

How to Contribute

Reporting Issues

1. Check if the issue already exists
2. Provide clear description and reproduction steps
3. Include Claude Code version and environment details
4. Add relevant error messages or screenshots

Suggesting New Skills

1. Open an issue with the skill-request label
2. Describe the skill's purpose and use cases
3. Explain why it would benefit the community
4. Provide examples of when it would activate

Submitting Skills

To submit a new skill to this marketplace:

1. Skill Quality Requirements

All skills must meet these standards:

**Required Structure:**

• ✅ SKILL.md with valid YAML frontmatter (name and description)
• ✅ Imperative/infinitive writing style (verb-first instructions)
• ✅ Clear "When to Use This Skill" section
• ✅ Proper resource organization (scripts/, references/, assets/)

**Quality Standards:**

• ✅ Comprehensive documentation
• ✅ Working code examples
• ✅ Tested functionality
• ✅ No TODOs or placeholder text
• ✅ Proper cross-referencing of bundled resources

**Best Practices:**

• ✅ Progressive disclosure pattern (metadata → SKILL.md → references)
• ✅ No duplication between SKILL.md and references
• ✅ Scripts have proper shebangs and are executable
• ✅ Clear activation criteria in description

2. Validation

Before submitting, validate your skill:

# Use skill-creator validation
~/.claude/plugins/marketplaces/anthropics-skills/skill-creator/scripts/quick_validate.py /path/to/your-skill

# Test in Claude Code
# 1. Copy skill to ~/.claude/skills/your-skill
# 2. Restart Claude Code
# 3. Verify skill activates correctly

3. Submission Process

1. **Fork this repository**

2. **Add your skill:**

   # Create skill directory
   mkdir your-skill-name
   
   # Add SKILL.md and resources
   # Follow the structure of existing skills

3. **Update marketplace.json:**

   {
     "skills": [
       // ... existing skills
       "./your-skill-name"
     ]
   }

4. **Update README.md:**

   • Add skill description to "Included Skills" section
   • Follow the existing format

5. **Test locally:**

   # Add your fork as marketplace
   claude plugin marketplace add https://github.com/your-username/claude-code-skills
   # Marketplace name comes from .claude-plugin/marketplace.json
   
   # Install and test
   claude plugin install productivity-skills@your-marketplace-name

6. **Submit Pull Request:**

   • Clear title describing the skill
   • Description explaining the skill's purpose
   • Link to any relevant documentation
   • Screenshots or examples (if applicable)

Improving Existing Skills

To improve an existing skill:

1. Open an issue describing the improvement
2. Fork the repository
3. Make your changes
4. Test thoroughl