Claude Skill MartBrowse skillsQuick linesLearn by videoTerminal guideWhat is a Skill?
 
← Back to list

Contributing to awesome-claude (HeyClaude)

A repo-specific playbook that guides Claude through the correct PR path, validation commands, and review gate for JSONbored/awesome-claude.

Dev & CodingIntermediate★ 291⑂ 119AI score 8/10Last updated: Jul 31, 2026

What it does

Encodes the contribution rules for the JSONbored/awesome-claude (HeyClaude) repository.

  • Classifies the contribution first: a single-file community content entry (content/<category>/<slug>.mdx) versus a platform/code change (apps/web, packages/registry, packages/mcp, scripts).
  • Clarifies who decides: content PRs go through a private, one-shot "HeyClaude submission gate"; platform PRs only get advisory comments from the gittensory-orb bot, with CI plus maintainer review holding merge authority.
  • Lists hard rejects: hand-editing generated files (README.md, apps/web/public/data/**, apps/web/src/generated/**, routeTree.gen.ts), asking HeyClaude to host ZIP/MCPB downloads, multi-account issue/PR farming, and chasing reviewers.
  • Right-sizes validation: pnpm validate:content:strict for content PRs; per-surface commands plus Codecov patch coverage of 70% for code PRs.
  • Corrects a common mistake: a linked issue is optional here, unlike sibling repos gittensory and metagraphed.

Who it's for

  • Authors submitting an agent, MCP server, skill, hook, command, or statusline to the HeyClaude directory
  • Developers fixing bugs in the site, registry package, or MCP package
  • Anyone who wants to pass the submission gate on the first try

Examples

  1. "Open a PR listing my MCP server on HeyClaude" — the skill checks content/SCHEMA.md, writes exactly one .mdx file with concrete safetyNotes/privacyNotes, then runs the strict content validator.
  2. "Fix this bug in the awesome-claude website" — it traces an existing analogue in apps/web/src/, scopes tests to the touched surface, and adds tests to clear the 70% patch-coverage gate.
  3. "Should I regenerate the README in my content PR?" — it flags that as maintainer-owned generated output and a reject reason.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/JSONbored/awesome-claude/HEAD/.claude/skills/contributing-to-awesome-claude/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the .claude/skills/contributing-to-awesome-claude folder from the GitHub repo JSONbored/awesome-claude into my ~/.claude/skills/contributing-to-awesome-claude/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/JSONbored/awesome-claude.git /tmp/awesome-claude && mkdir -p ~/.claude/skills && cp -r /tmp/awesome-claude/.claude/skills/contributing-to-awesome-claude ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Open your terminal.
  2. Clone the repository into a temp folder: git clone https://github.com/JSONbored/awesome-claude.git /tmp/awesome-claude
  3. Create the skills directory: mkdir -p ~/.claude/skills
  4. Copy the skill folder (the sibling reference.md must come along): cp -r /tmp/awesome-claude/.claude/skills/contributing-to-awesome-claude ~/.claude/skills/
  5. Verify with ls ~/.claude/skills/contributing-to-awesome-claude — you should see SKILL.md and reference.md.
  6. Restart Claude Code and say something like "help me submit an entry to awesome-claude" to trigger it.
  7. Install pnpm beforehand so the validation commands can actually run.
View source on GitHub ↗License: MIT