Skip to content

GitHub Pull Request Workflow

Prepare clean GitHub pull requests with clear titles, bodies, verification notes and review replies

Stars
110,078
Licence
MIT
Files
1 file

What it does

When installed, the agent follows a checklist for opening and maintaining GitHub pull requests: tidying the branch and commits, writing a short imperative title, and filling in a structured body with a summary, implementation notes, verification steps and rollback plan. It also guides how to add screenshots for UI changes and how to reply to reviewer comments and re-request review. It is written as guidance only and does not run anything itself.

Great for

  • Software engineers preparing a feature branch for review on GitHub
  • Teams that want consistent PR titles and descriptions
  • Developers responding to a stack of review comments on an open PR

Skip it if

  • Repositories hosted on non-GitHub forges, since the file itself says to adapt conventions rather than force GitHub-specific steps
  • Changes that are not yet functionally complete, because the skill advises against opening draft PRs that will bounce on review
  • Non-developers with no git or pull request experience, who may find the workflow assumes familiarity with rebasing and commits

Try asking

  • “Help me write the title and body for my PR that adds CSV export to the reports table”
  • “A reviewer left five comments on my PR, draft replies and tell me what to push”
  • “Clean up my feature branch commits before I open a pull request”
  • “Write the verification and rollback sections for my database migration PR”
Step-by-step guide: how to use GitHub Pull Request WorkflowInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    github-pr-workflow.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip github-pr-workflow.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip github-pr-workflow.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Give the agent your diff or branch name so it can write a body grounded in the actual changes
  • State which tests, lint and typecheck commands you ran so the Verification section is accurate rather than invented
  • Review the generated title and body before posting, since the agent may not know your project's issue prefix or CI details unless you mention them

What's inside

  • SKILL.md

Redistributed unmodified from paperclipai/paperclip under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.