pr-ship

Runs pre-merge gate checks, reviewer fan-out, and DoD walk to return a SHIP or HOLD verdict.

Updated Jul 23, 2026
One-click install
npx skills add https://github.com/serhii-baksheiev/create-agent-rig --skill pr-ship-serhii-baksheiev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pr-ship
Source: https://github.com/serhii-baksheiev/create-agent-rig/tree/main/.agents/skills/pr-ship
Command: npx skills add https://github.com/serhii-baksheiev/create-agent-rig --skill pr-ship-serhii-baksheiev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Merging a pull request without a consistent, enforced review process lets regressions, security issues, and unmet requirements slip through. This Skill acts as the final pre-merge gate: it runs the project's full check suite, routes the diff to the right reviewers, verifies their verdicts, and returns an explicit SHIP or HOLD decision with named blockers. ## Core Features & Use Cases - Gate round accounting: Counts each review round per branch against a configurable cap (default 2), refusing to run on dirty trees, missing upstreams, or unpushed commits so rounds are never wasted. - Diff routing and reviewer fan-out: Classifies the committed diff into deterministic, fast-path, or model lanes via a decision router, then launches the required reviewers (code-reviewer, prose-reviewer, security-scanner) with lane-independent triggers that can only add reviewers. - Verdict validation and coverage check: Parses each reviewer's JSON verdict, rejects malformed or incomplete reports, journals decisions to a run trace, and compares launched versus answered reviewers before walking the Definition of Done. - Use Case: Before merging a feature branch, invoke the gate to revalidate the branch against the remote default branch, run the test suite, fan out reviewers in parallel, and receive a HOLD listing the exact failing check and file:line blocker — or a clean SHIP. ## Quick Start Ask the agent to run the pr-ship gate on the current branch before opening the pull request and report the SHIP or HOLD verdict with any blockers.

Frequently Asked Questions about pr-ship

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a pre-merge review gate before opening a pull request?

Invoke the pr-ship skill on the branch under review. It counts a gate round, diffs against the remote default branch, routes the diff to reviewers, runs the project's check suite, and returns a SHIP or HOLD verdict with named blockers.

How does the decision router choose which reviewers to launch?

The router classifies the committed diff into deterministic, fast-path, or model lanes based on changed paths and risk flags. The lane sets a reviewer floor, and lane-independent triggers add security-scanner or prose-reviewer when the diff touches auth, secrets, rule files, or infrastructure.

What does a HOLD verdict with gate rounds exhausted mean?

Each branch gets a capped number of gate rounds, two by default, tracked in .claude/gate-rounds.json. When the cap is spent, the gate returns HOLD with a gate-rounds-exhausted blocker instead of running the reviewer fan-out again.

Why does the gate refuse to run on a dirty working tree?

The round counter refuses dirty trees, branches without upstream, or unpushed commits so a round is never counted against a head that cannot ship. Commit and push first, then rerun the gate from step 0.

Can the pr-ship gate merge or fix code itself?

No. The gate only verifies and reports; it never merges, pushes, or edits files. A HOLD goes back to the author with named blockers, and after fixes the gate reruns from step 0, which counts a new round.