# ship-pr

ship-pr delivers finished work with documentation audits, release note grouping, compliant commits, and a pull request.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 181 installs · ★ 655 repo stars
- Author: Pedro Nauck
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pedronauck/skills/tree/HEAD/skills/mine/ship-pr/SKILL.md
- Updated: 2026-10-20
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/ship-pr

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill ship-pr -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/ship-pr/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/ship-pr/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill ship-pr -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/ship-pr/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill ship-pr -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/ship-pr/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pedronauck/skills skills/mine/ship-pr
```

2. **Manually: put the files in place**
- File: `.github/skills/ship-pr/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill ship-pr -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/pedronauck/skills --path skills/mine/ship-pr
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/ship-pr/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill ship-pr -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/pedronauck/skills/tree/HEAD/skills/mine/ship-pr/SKILL.md

## When to use it
- 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
- 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

## Similar
- [gsd-ship](https://affpapa.org/en/nevibecode/skills/gsd-ship.md) — skill · 582 installs
- [ship-it](https://affpapa.org/en/nevibecode/skills/ship-it.md) — skill · 1700 installs
- [autofix](https://affpapa.org/en/nevibecode/skills/autofix.md) — skill · 12100 installs
- [github-pr-review](https://affpapa.org/en/nevibecode/skills/github-pr-review.md) — skill · 581 installs
- [gh-dash](https://affpapa.org/en/nevibecode/plugins/gh-dash.md) — plugin · ★ 23 repo stars
- [ds-ship](https://affpapa.org/en/nevibecode/skills/ds-ship.md) — skill · 534 installs

From the same set: [pedronauck/skills](https://affpapa.org/en/nevibecode/by/pedronauck/skills.md) — 52 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
