# contributing-to-awesome-claude

Adopt this skill: https://proskills.md/skills/other/jsonbored-awesome-claude-claude-skills-contributing-to-awesome-claude

Page: https://proskills.md/skills/other/jsonbored-awesome-claude-claude-skills-contributing-to-awesome-claude
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: .claude/skills/contributing-to-awesome-claude/SKILL.md
size: 7482
upstream: https://github.com/jsonbored/awesome-claude/blob/main/.claude/skills/contributing-to-awesome-claude/SKILL.md

````text
---
name: contributing-to-awesome-claude
description: >-
  Use when writing, testing, or preparing ANY contribution or pull request to the
  JSONbored/awesome-claude (HeyClaude) repo — adding a community content entry
  (agent/MCP server/skill/hook/command/rule/guide/collection/statusline), or making a
  platform/code change (website, registry package, MCP package, scripts). The repo has
  two separate review paths: a private, one-shot "HeyClaude submission gate" that decides
  single-file content PRs, and the shared gittensory-orb bot that posts an advisory
  readiness/linked-issue comment on platform/code PRs but does not itself merge or close
  content PRs. Unlike JSONbored/gittensory and JSONbored/metagraphed, a linked issue is
  OPTIONAL here — do not import their mandatory-linked-issue rule into this repo. Invoke
  for any "contribute to / open a PR against / submit an entry to / fix a bug in
  awesome-claude (HeyClaude)" task.
---

# 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/optional fields
   per category) and `examples/content/SUBMISSION_EXAMPLES.md` (accepted vs.
   rejected/rerouted examples — read this before you draft anything non-trivial).
2. **One file, one PR.** Add exactly one `content/<category>/<slug>.mdx`. Do not touch
   `README.md`, `apps/web/public/data/**`, `apps/web/src/generated/**`,
   `apps/web/src/routeTree.gen.ts`, or `apps/web/public/downloads/**` — those are
   maintainer-owned generated outputs and editing them in a content PR is a reject
   reason.
3. **Source-back everything.** Canonical source/docs/repo URLs, not affiliate or
   tracking links. For hooks, MCP servers, skills, commands, and statuslines, fill
   `safetyNotes` (execution, install, writes, destructive actions, background workers,
   network access, account writes) and `privacyNotes` (local files, logs, credentials,
   telemetry, retained data) — use `prerequisites` only for setup requirements and
   `disclosure` only for commercial/listing status, not runtime safety.
4. **A linked issue is genuinely optional here.** CONTRIBUTING.md says plainly: "a PR
   with no linked issue is fine." Filing your own issue and resolving it is fine too.
   What is *not* fine is multi-account farming (opening an issue on one account,
   "resolving" it from another) — see `reference.md` §4 for the exact contrast with
   gittensory/metagraphed's mandatory policy.
5. **Validate narrowly** — a content PR does not need the full platform test suite:
   ```sh
   pnpm install --frozen-lockfile
   pnpm validate:content:strict
   ```
   Do not run `generate:readme` / `generate:openapi` or commit build output for a
   one-file content submission — those are build-time outputs regenerated by CI/deploy.
6. **Understand who actually decides your PR's fate.** It is the private submission
   gate, not gittensory-orb — see the Step 1 architecture note below and `reference.md`
   §2 for the full disposition table.

---

## If you're making a platform/code change

1. **Trace an existing analogue** in `apps/web/src/`, `packages/registry/src/`, or
   `packages/mcp/` before writing new code — the repo has a strong existing house style
   per surface.
2. **Scope your validation to the surface you touched** — see `reference.md` §3 for the
   exact command lists AGENTS.md prescribes per change type (README, submission/API,
   or general platform).
3. **Codecov is enforcing, not informational, on code changes.** `codecov/patch`
   requires **70%** coverage of your changed lines (5% threshold), and `codecov/project`
   compares against your PR's own base commit (`target: auto`, 1% threshold). Both post
   a real pass/fail status — see `reference.md` §5 for the exact `codecov.yml` values and
   what's ignored (`tests/`, `**/*.test.ts`, `**/*.config.ts`,
   `apps/web/src/generated`, `apps/web/public/data`, `integrations`).
4. **Regenerate what you invalidate, then commit it** — see `reference.md` §3 for the
   exact regen command per surface (README, OpenAPI, etc.). Keep generated-artifact
   churn out of PRs that don't need it; external contributors especially should leave
   generated output out unless a maintainer asks for it.
5. **gittensory-orb reviews your PR, but advisory only.** It posts a readiness score,
   linked-issue/no-issue check, and coverage-evidence comment — useful signal, but it
   is not the merge authority for platform PRs either; ordinary CI + maintainer review
   is (see `reference.md` §2).

---

## Common pitfalls (both paths)

- **Editing generated files.** `README.md`, `apps/web/public/data/**`,
  `apps/web/src/generated/**`, `apps/web/src/routeTree.gen.ts` are maintainer-owned
  outputs. Hand-editing them (in either a content or platform PR) is flagged/rejected.
- **Requesting HeyClaude host your ZIP/MCPB.** Community package uploads for hosting at
  `/downloads/...` are not accepted — link the source repo, an install command, or
  copyable source content instead. Maintainer-built download artifacts are a separate,
  post-review, maintainer-only path.
- **Bringing gittensory/metagraphed's mandatory-linked-issue habit here.** It does not
  apply — see `reference.md` §4.
- **Missing safety/privacy notes on a risk-bearing entry** (a hook, MCP server, skill,
  command, or statusline that executes code, writes files, calls out to third parties,
  or runs in the background). Generic boilerplate is a common review nit; be specific
  about what the resource can actually do.
- **Multi-account issue/PR farming.** Explicitly against policy and is a permanent,
  cross-repo block per `CODE_OF_CONDUCT.md` — not a gray area.
- **Chasing a review.** CONTRIBUTING.md warns that pinging for status on a queued
  submission *deprioritizes* it (adds ~5 days to the manual queue) rather than
  speeding it up.

---

When you need the exact command lists, the full two-gate disposition tables, or the
current Codecov numbers verified against the live `codecov.yml`, read **`reference.md`**
in this skill directory.
````

## File: README.md
upstream: https://github.com/jsonbored/awesome-claude/blob/main/README.md

```text
<table>
  <tr>
    <td width="58%" valign="top">
      <picture>
        <source media="(prefers-color-scheme: dark)" srcset="https://heyclau.de/heyclaude-wordmark-dark.svg">
        <img src="https://heyclau.de/heyclaude-wordmark.svg" alt="HeyClaude" width="260">
      </picture>
      <h3>Curated Claude workflow infrastructure.</h3>
      <p>
        HeyClaude is a file-backed, human-reviewed directory for Claude agents,
        MCP servers, skills, hooks, commands, tools, prompts, rules, guides,
        templates, and statuslines.
      </p>
      <p>
        <strong>1388+ file-backed entries</strong> stay useful as both an
        awesome-list catalog and a machine-readable registry for builders.
      </p>
      <p>
        <a href="https://heyclau.de"><img alt="Website" src="https://img.shields.io/badge/Website-heyclau.de-c855a0?style=for-the-badge&logo=googlechrome&logoColor=white"></a>
        <a href="https://heyclau.de/browse"><img alt="Browse" src="https://img.shields.io/badge/Browse-directory-2d7ff9?style=for-the-badge&logo=icloud&logoColor=white"></a>
        <a href="https://heyclau.de/submit"><img alt="Submit" src="https://img.shields.io/badge/Submit-resource-36b37e?style=for-the-badge&logo=githubsponsors&logoColor=white"></a>
      </p>
      <p>
        <a href="https://heyclau.de/api-docs"><img alt="API docs" src="https://img.shields.io/badge/API-docs-111827?style=flat-square&logo=openapiinitiative&logoColor=white"></a>
        <a href="packages/mcp"><img alt="MCP package" src="https://img.shields.io/badge/MCP-package-7c3aed?style=flat-square&logo=npm&logoColor=white"></a>
        <a href="https://heyclau.de/api/mcp"><img alt="Remote MCP endpoint" src="https://img.shields.io/badge/Remote-MCP-7c3aed?style=flat-square&logo=protocolsdotio&logoColor=white"></a>
        <a href="integrations/raycast"><img alt="Raycast" src="https://img.shields.io/badge/Raycast-extension-ff6363?style=flat-square&logo=raycast&logoColor=white"></a>
        <a href="https://heyclau.de/llms-full.txt"><img alt="LLM export" src="https://img.shields.io/badge/LLM-export-0f766e?style=flat-square&logo=readme&logoColor=white"></a>
        <a href="https://heyclau.de/api/registry/feed"><img alt="Registry feed" src="https://img.shields.io/badge/Registry-feed-2563eb?style=flat-square&logo=json&logoColor=white"></a>
        <a href="https://heyclau.de/feed.xml"><img alt="RSS feed" src="https://img.shields.io/badge/RSS-feed-f97316?style=flat-square&logo=rss&logoColor=white"></a>
        <a href="https://heyclau.de/jobs"><img alt="Jobs" src="https://img.shields.io/badge/Jobs-board-8b5cf6?style=flat-square&logo=briefcase&logoColor=white"></a>
        <a href="https://heyclau.de/claim"><img alt="Claim or update" src="https://img.shields.io/badge/Claim-update-c855a0?style=flat-square&logo=github&logoColor=white"></a>
      </p>
    </td>
    <td width="42%" valign="top">
      <h3>Registry snapshot</h3>
      <table>
        <tr>
          <td align="center"><strong>1388</strong><br><sub>entries</sub></td>
          <td align="center"><strong>10</strong><br><sub>sections</sub></td>
          <td align="center"><strong>AI-reviewed</strong><br><sub>merge gate</sub></td>
        </tr>
        <tr>
          <td align="center"><strong>source</strong><br><sub>first UGC</sub></td>
          <td align="center"><strong>no ZIP</strong><br><sub>community uploads</sub></td>
          <td align="center"><strong>API</strong><br><sub>MCP + feeds</sub></td>
        </tr>
      </table>
      <p>
        <a href="https://github.com/hesreallyhim/awesome-claude-code/blob/main/README_ALTERNATIVES/README_EXTRA.md#workflows--knowledge-guides-"><img src="https://awesome.re/mentioned-badge.svg" alt="Mentioned in Awesome Claude Code"></a>
        <a href="https://smithery.ai/servers/heyclaude/heyclaude"><img src="https://smithery.ai/badge/heyclaude/heyclaude" alt="Listed on Smithery"></a>
      </p>
      <p>
        <a href="https://gittensor.io/miners/repository?name=JSONbored/awesome-claude"><img src="https://api.gittensor.io/repos/JSONbored%2Fawesome-claude/badge.svg" alt="Gittensor impact"></a><br>
        <sub>Unofficial community project. Contribution eligibility and rewards follow Gittensor's current rules.</sub>
      </p>
    </td>
  </tr>
</table>

## Gittensor Contributor Impact

<p align="center">
  <a href="https://gittensor.io/miners/repository?name=JSONbored/awesome-claude">
    <img src="https://raw.githubusercontent.com/JSONbored/awesome-claude/gittensor-impact-assets/gittensor-impact-dark.svg" alt="Gittensor contributor impact" width="600">
  </a>
</p>

Refreshed weekly by [`.github/workflows/gittensor-impact.yml`](.github/workflows/gittensor-impact.yml). Unofficial community project — contribution eligibility and rewards follow Gittensor's current rules.

## Explore The Directory

<table>
<tr>
<td align="center" width="20%">
          <a href="#ai-agents"><strong>🤖 Agents</strong></a><br>
          <code>106</code><br>
          <sub>Specialized Claude agents and expert roles.</sub>
        </td>
<td align="center" width="20%">
          <a href="#mcp-servers"><strong>🔌 MCP Servers</strong></a><br>
          <code>483</code><br>
          <sub>Model Context Protocol servers and integrations.</sub>
        </td>
<td align="center" width="20%">
          <a href="#tools"><strong>🧰 Tools</strong></a><br>
          <code>205</code><br>
          <sub>Apps, developer tools, services, and products for Claude-native builders.</sub>
        </td>
<td align="center" width="20%">
          <a href="#skills"><strong>🧠 Skills</strong></a><br>
          <code>179</code><br>
          <sub>Source-backed skill packs and reusable capabilities.</sub>
        </td>
<td align="center" width="20%">
          <a href="#rules"><strong>📏 Rules</strong></a><br>
          <code>90</code><br>
          <sub>Prompt guardrails, project rules, and operating constraints.</sub>
        </td>
</tr>
<tr>
<td align="center" width="20%">
          <a href="#commands"><strong>⌨️ Commands</strong></a><br>
          <code>43</code><br>
          <sub>Slash commands and reusable command prompts.</sub>
        </td>
<td align="center" width="20%">
          <a href="#hooks"><strong>🪝 Hooks</strong></a><br>
          <code>87</code><br>
          <sub>Claude Code hook configs and automation helpers.</sub>
        </td>
<td align="center" width="20%">
          <a href="#guides"><strong>📚 Guides</strong></a><br>
          <code>128</code><br>
          <sub>Long-form guides and practical walkthroughs.</sub>
        </td>
<td align="center" width="20%">
          <a href="#collections"><strong>📦 Collections</strong></a><br>
          <code>25</code><br>
          <sub>Curated bundles of related assets.</sub>
        </td>
<td align="center" width="20%">
          <a href="#statuslines"><strong>📟 Statuslines</strong></a><br>
          <code>42</code><br>
          <sub>Statusline scripts and workflow telemetry.</sub>
        </td>
</tr>
</table>

## Choose Your Path

<table>
  <tr>
    <td width="25%" valign="top">
      <h3>🔎 Discover</h3>
      <p>Search the curated directory and jump from README entries into richer detail pages.</p>
      <p><a href="https://heyclau.de/browse"><strong>Browse resources</strong></a></p>
    </td>
    <td width="25%" valign="top">
      <h3>🧾 Contribute</h3>
      <p>Submit free, source-backed Claude resources through PR-first private-gate review.</p>
      <p><a href="https://heyclau.de/submit"><strong>Submit content</strong></a></p>
    </td>
    <td width="25%" valign="top">
      <h3>⚙️ Integrate</h3>
      <p>Use the registry as JSON, RSS, Atom, LLM text, Raycast data, or a read-only MCP server.</p>
      <p><a href="https://heyclau.de/api-docs"><strong>API docs</strong></a> · <a href="packages/mcp">MCP package</a></p>
    </td>
    <td width="25%" valign="top">
      <h3>💼 List</h3>
      <p>Claim an entry, post a Claude role, or route commercial listings through the website.</p>
```
