← Back to Documentation

Contributing Guide

Help grow the AI agent ecosystem

⏱️ 10 min read • 📚 All levels

Why Contribute?

🌟

Recognition

Your name in contributors list. Build your open source portfolio.

🤝

Community

Join a growing community of AI agent developers.

📈

Impact

Your plugins will be used by developers worldwide.

Ways to Contribute

✏️

Improve Existing Plugins

The easiest way to start. Pick any of our 69 plugins and enhance it:

  • • Fix bugs or typos in agent prompts
  • • Add better examples and documentation
  • • Enhance skill templates with real-world patterns
  • • Add new commands for common workflows
🆕

Create New Plugins

Have expertise in a domain we haven't covered? Create a new plugin:

  • • Follow the plugin structure guidelines
  • • Use Golden Format for skills
  • • Include comprehensive documentation
  • • Submit via pull request
🐛

Report Issues

Found a bug or have a suggestion? Let us know:

  • • Search existing issues first to avoid duplicates
  • • Provide clear reproduction steps
  • • Include Claude Code version and OS
  • • Share relevant error messages
Open an Issue →
📚

Improve Documentation

Great documentation is as important as great code:

  • • Fix typos and unclear explanations
  • • Add examples and tutorials
  • • Translate to other languages
  • • Create video walkthroughs

Contribution Workflow

1

Fork the Repository

Start by forking the plugin repository you want to improve:

git clone https://github.com/YOUR-USERNAME/custom-plugin-python.git
2

Create a Branch

Create a descriptive branch for your changes:

git checkout -b feature/add-type-hints-skill
3

Make Your Changes

Follow our guidelines while making changes:

  • • Use SASMP v1.3.0 format for agents/skills
  • • Follow Golden Format for skill structure
  • • Test locally before committing
  • • Write clear commit messages
4

Validate Your Plugin

Run validation to catch issues before submitting:

/plugin validate .
5

Submit Pull Request

Push your changes and open a pull request:

git push origin feature/add-type-hints-skill

Then open a PR on GitHub with a clear description of your changes.

Code Standards

SASMP v1.3.0 Compliance

All agents and skills must follow SASMP (Skill-Agent-Skill-Mapping Protocol):

Agent Requirements

  • • sasmp_version: "1.3.0"
  • • eqhm_enabled: true
  • • Unique name per plugin
  • • Clear role description

Skill Requirements

  • • bonded_agent: agent-name
  • • bond_type: PRIMARY_BOND
  • • Golden Format structure
  • • Real content (no placeholders)

Common E-Code Violations to Avoid

Code Issue Fix
E103 Missing YAML frontmatter Add name, model, tools fields
E502 Orphan skill Add bonded_agent field
E701 Missing Golden Format Add assets/scripts/references
E702 Empty placeholder files Add real content to assets

Pull Request Template

PR Description 
## Summary
Brief description of your changes.

## Type of Change
- [ ] Bug fix
- [ ] New feature
- [ ] Documentation update
- [ ] Code improvement

## Changes Made
- Added X to agent Y
- Fixed bug in skill Z
- Updated documentation for...

## Testing
- [ ] Ran `/plugin validate`
- [ ] Tested in Claude Code
- [ ] All agents load correctly
- [ ] Skills invoke successfully

## Checklist
- [ ] Follows SASMP v1.3.0 format
- [ ] Golden Format for skills (if applicable)
- [ ] No E-code violations
- [ ] Clear commit messages

Community Guidelines

  • ✓
    Be Respectful

    Treat all contributors with respect. We're all here to learn and improve.

  • ✓
    Be Constructive

    When reviewing code, focus on improvement suggestions rather than criticism.

  • ✓
    Be Patient

    Maintainers are volunteers. Allow reasonable time for PR reviews.

  • ✓
    Document Everything

    Good documentation helps everyone. Explain your changes clearly.

Ready to Contribute?

Join our growing community of AI agent developers.

View on GitHub Browse Plugins