ship-pr — Claude Code skill: what it does, how to install
ship-pr delivers finished work with documentation audits, release note grouping, compliant commits, and a pull request.
no license 181 installs ★ 655 updated 2026-10-20
npx skills add pedronauck/skills --skill ship-pr -a claude-codeWhat ship-pr does
This workflow guides completed code into a clean delivery state. It reviews active branches and staged diffs, matches public behavior changes against existing documentation, and compiles batched updates for release notes.
Commit checks run strictly under project rules. The routine requires following commitlint and local hooks, forbidding fabricated model attribution or forced hook bypasses. When authorized, it pushes the branch and opens the PR via gh using the repository template.
External review watchers such as CodeRabbit run only when explicitly prompted. The companion detect-tooling.sh script detects available CLI tools on PATH without automatically authorizing fixes or continuous polling loops.
What it helps with
- create a structured pull request via gh using project templates
- trace modified public behavior into affected documentation
- group release notes according to repository policy
- commit scoped changes without bypassing commitlint or git hooks
Example prompts for the agent
- Prepare a pull request for current changes with release notes and docs checks
- Stage owned files, run project checks, and open the PR with gh
- Audit branch impact, draft the PR body, and monitor CodeRabbit review
How to install ship-pr
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill ship-pr -a claude-code2Manually: put the files in place
~/.claude/skills/ship-pr/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ship-pr/
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill ship-pr -a codex2Manually: put the files in place
.agents/skills/ship-pr/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill ship-pr -a cursor2Manually: put the files in place
.cursor/skills/ship-pr/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install pedronauck/skills skills/mine/ship-pr2Manually: put the files in place
.github/skills/ship-pr/SKILL.md1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill ship-pr -a gemini-cli2Platform CLI
gemini skills install https://github.com/pedronauck/skills --path skills/mine/ship-prManually: put the files in place
.devin/skills/ship-pr/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add pedronauck/skills --skill ship-pr -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about ship-pr
How to install ship-pr in Claude Code?
Run npx skills add pedronauck/skills --skill ship-pr -a claude-code. The definition is stored at ~/.claude/skills/ship-pr/SKILL.md.
What does ship-pr do?
It handles end-of-branch tasks: auditing documentation updates, grouping release notes, staging code under project commit conventions, and publishing PRs via gh.
Does ship-pr automatically apply CodeRabbit remediation?
No, automated remediation and pushes require distinct user authorization. Tool presence in PATH merely indicates availability, not permission to alter code.