Skip to content
Get packs

Prepare Paperclip PR

Walks an agent through committing, rebasing, and opening a reviewed PR to paperclipai/paperclip

Source Download skill
Repository
paperclipai/paperclip
Stars
110,078
Licence
MIT
Files
1 file

What it does

When a developer asks an agent to get work ready for the Paperclip open-source project, this skill gives the agent a fixed checklist to follow. It tells the agent to work in a separate git worktree, commit all changes in logical commits, rebase onto the latest master, avoid committing certain files (such as the lockfile and workflow files), open the pull request following the project's CONTRIBUTING guide, and then repeatedly run the Greptile and CI review loops until checks pass. It also requires the agent to report the PR URLs and worktree path back to the task.

Great for

  • Developers contributing to the paperclipai/paperclip repository who want a consistent PR process
  • Maintainers or team members who run multi-PR splits from one branch and need the same steps for each
  • Teams already using the Paperclip company skills /greploop and /prcheckloop

Skip it if

  • Projects other than paperclipai/paperclip, since it hard-codes that repo's rules, remotes, and tooling; it would give wrong instructions elsewhere
  • Anyone without access to the Paperclip repo and its Greptile and CI setup, because the review loops cannot run without them
  • Situations where an agent should not push or open PRs without a human reviewing first, since the skill tells the agent to push and keep looping on review until it reaches 5/5

Try asking

  • “Prepare my current branch for a PR against paperclipai/paperclip master, following the standard procedure”
  • “Split this branch into two PRs under the 100-file limit and run the full PR process for each”
  • “Rebase my feature branch on master, clean up the commits, and open the PR with gh”
Step-by-step guide: how to use Prepare Paperclip PRInstall, 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.

    prepare-paperclip-pr.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip prepare-paperclip-pr.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip prepare-paperclip-pr.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

  • Check the worktree and branch before the agent starts, because the skill assumes the main ~/paperclip checkout runs a live server and must not be switched.
  • Review the commits and the rewritten history before pushing, since the skill involves rebasing and the agent should never force-push over commits.
  • Set a turn limit or watch the Greptile loop, because the skill says not to stop until 5/5, which can run up to 20 turns.

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.