63 lines (41 loc) · 1.86 KB

Contributing

Thanks for your interest in contributing to claude-awesome-stack!

What You Can Contribute

New Stacks

Create a complete stack for a technology domain. See docs/creating-stacks.md for the full guide.

New Skills

Add individual skills to an existing stack. Skills go in stacks/<stack>/skills/<skill-name>/SKILL.md.

Hook Recipes

Add new hook patterns to curated/hooks.md with working JSON config and script.

Curated List Entries

Add entries to the curated lists:

curated/mcp-servers.md -- MCP servers you've used and can vouch for
curated/skills.md -- Community skills you've tested
curated/hooks.md -- Hook patterns that work well

PR Process

Fork the repo and create a branch
Make your changes
Test your changes (see below)
Submit a PR with a clear description

What to include in your PR

What: Brief description of what you're adding or changing
Why: What problem does this solve?
Testing: How you verified it works
Screenshots: If applicable (skill in action, hook output, etc.)

Quality Standards

For stacks

Must include README, CLAUDE.md, settings.json, and at least one skill
Hooks must degrade gracefully when tools aren't installed
Must be tested with a fresh install

For skills

Clear, specific description in YAML frontmatter
Step-by-step instructions (not vague guidance)
Include verification/checklist at the end

For curated list entries

Must link to a real, publicly accessible resource
Must include a concise, accurate description
Ideally tested by the contributor

Code of Conduct

Be respectful and constructive. We're all here to make Claude Code better for everyone.

Questions?

Open an issue if you have questions about contributing.