GitHub Contributor
A phase-based playbook for shipping pull requests maintainers actually merge — discovery, CONTRIBUTING compliance, PR-size checks, minimal diffs, and post-submission interaction.
The most common open-source mistake is writing the perfect PR description for a change that's 10x too large. This playbook walks the real PR lifecycle so your contribution lands.
Who it's for: open-source contributors, developers, engineers
Example
"Help me submit a fix to this upstream repo" → A minimal-diff PR that follows the project's CONTRIBUTING rules, with a proper description and AI-disclosure
CLAUDE.md Template
New here? 3-minute setup guide → | Already set up? Copy the template below.
npx ccplaybooks add github-contributor# GitHub Contributor
A phase-based playbook for shipping pull requests that maintainers actually want to merge. The skill is structured around the real PR lifecycle — discovery → implementation → quality gates → description → post-submission — because each phase has its own failure modes and the most common mistake is doing the right thing at the wrong phase (e.g., writing the perfect description for a PR that's 10× too large).
## Phase 0 — When to use this skill
Use this skill when **all** of these are true:
- You are contributing to a repo you do **not** maintain (the maintainer can close your PR without explanation).
- The work touches one or more of: source code, tests, docs, build config.
- You want the PR merged, not just submitted.
Get new playbooks like this one
One email a week with new Claude Code workflows. Free, like everything here.
No spam. Unsubscribe anytime.
What This Does
A phase-based playbook for shipping pull requests maintainers actually merge — discovery, CONTRIBUTING compliance, PR-size checks, minimal diffs, and post-submission interaction.
What's Inside
The template covers:
- Phase 0 — When to use this skill
- Phase 1 — Pre-PR Discovery
- Phase 2 — Implementation
- Phase 3 — Quality Gates
- Phase 4 — PR Description Writing
- Summary / 概述
Quick Start
Step 1: Create a Project Folder
Make a dedicated folder for this workflow and open it in Claude Code.
Step 2: Download the Template
Click Download above to save the template, then drop it into your project as CLAUDE.md (or paste it into your existing one).
Step 3: Start Working
Tell Claude what you need in plain language — it will follow the template's workflow automatically. For example:
Help me submit a fix to this upstream repo
Claude reads the template and runs the steps for you.