# ship-it

Takes a finished change all the way to a ready pull request: commits, pushes, opens the PR and watches CI until it passes.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1700 installs
- Author: jssblck
- License: GPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/jssblck/agents/tree/HEAD/skills/ship-it/SKILL.md
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/skills/ship-it

## What it does

The skill covers the whole path from finished code to a published PR. It works on a feature branch, inspects the diff and working tree, groups related files into logical commits and leaves unrelated user changes alone. If a PR is already open, it reuses that one and marks it ready with `gh pr ready` — unless you asked to keep the draft.

Verification comes next. The skill reads the repo's check commands, runs the required local tests and adds a Testing section to the PR body with exact commands and results. Screenshots and recordings go up through `gh --attach`. Once the PR is published, it calls `babysit` to catch merge conflicts and watch the full check set through completion.

It will not merge without being asked, and it keeps narrow requests narrow: a CI-only repair fixes the branch without creating a PR, monitoring just reports. You need `gh` with access to the repository, or the push and PR steps stop there.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

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

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add jssblck/agents --skill ship-it -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add jssblck/agents --skill ship-it -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install jssblck/agents ship-it
```

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

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/jssblck/agents --path skills/ship-it
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add jssblck/agents --skill ship-it -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/jssblck/agents/tree/HEAD/skills/ship-it/SKILL.md

## When to use it
- commit a finished change and open a pull request
- split edits into logical commits without touching unrelated files
- wait out CI and fix failing checks
- collect verification evidence into the PR body
- reuse an existing open PR instead of creating a new one

## Example prompts
- ship this change
- commit and open a PR on this branch
- push the changes and watch CI

## Similar
- [verify-and-ship](https://affpapa.org/en/nevibecode/skills/verify-and-ship.md) — skill · 843 installs
- [gh-issues](https://affpapa.org/en/nevibecode/skills/gh-issues.md) — skill · 5000 installs
- [babysitting-pr](https://affpapa.org/en/nevibecode/skills/babysitting-pr.md) — skill · 427 installs
- [om-auto-continue-pr](https://affpapa.org/en/nevibecode/skills/om-auto-continue-pr.md) — skill · 3700 installs
- [yeet](https://affpapa.org/en/nevibecode/skills/yeet.md) — skill · 3400 installs
- [om-approve-merge-pr](https://affpapa.org/en/nevibecode/skills/om-approve-merge-pr.md) — skill · 3500 installs

---
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