contributing-to-awesome-claude

# Contributing to awesome-claude (HeyClaude) HeyClaude is a file-backed directory of Claude/AI workflow resources (`content/<category>/<slug>.mdx`) plus a website, registry package, and MCP package that serve that content. It has **two kinds of contribution with two different review mechanisms** — get the kind right first, everything else follows from it. `reference.md` (next to this file) has the exhaustive command tables, the two-gate architecture in detail, the current Codecov numbers, and the content-PR pitfalls. Read it when a section below tells you to. --- ## Step 0 — Which kind of contribution is this? | You are... | Contribution type | Review mechanism | |---|---|---| | Adding/editing one `content/<category>/<slug>.mdx` entry (agent, MCP server, skill, hook, command, rule, guide, collection, statusline) | **Community content** | Private **HeyClaude submission gate** (one-shot, aggressive) | | Changing `apps/web/**`, `packages/registry/**`, `packages/mcp/**`, `scripts/**`, workflows | **Platform/code** | Standard CI + the shared **gittensory-orb** bot (advisory) | These are handled by genuinely different systems (see `reference.md` §1). **Do not mix them in one PR** — CONTRIBUTING.md is explicit that a content PR touches exactly one `content/<category>/<slug>.mdx` file, and platform/code changes should stay separate from individual content imports. --- ## If you're adding a content entry 1. **Read the schema and examples first**: `content/SCHEMA.md` (required...