ship-pr

ship-pr is a skill for Claude Code, Codex from nikeyes/stepwise-dev. It costs 53 tokens per session (1,135 once invoked), scanned A, original, Apache-2.0.

A workflow that takes repository changes through commits, a pushed branch, a pull request, automated checks, and review replies. A pull request is a proposed change that others review before it is merged.

In plain words
What is it for?
Use it to turn current work into a merge-ready pull request, including committing, pushing, opening the request, waiting for checks, and responding to comments.
Why use it?
It removes the need to coordinate each delivery step manually and can address check failures and review comments in up to three rounds. It never merges the pull request or force-pushes.

Skill for Claude CodeCodex

Written for Claude Code and Codex: allowed-tools in frontmatter, but also agents/openai.yaml present. Also seen: model in frontmatter.

Part of the stepwise-git plugin — 4 skills shipped together

Good fit Use it to turn current work into a merge-ready pull request, including committing, pushing, opening the request, waiting for checks, and responding to comments.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/nikeyes/stepwise-dev/ship-pr
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add nikeyes/stepwise-dev --skill ship-pr
Clone the repo
git clone --depth 1 https://github.com/nikeyes/stepwise-dev

Made for: Claude Code, Codex.

Or install stepwise-git, the plugin that ships this one along with the rest of its 4 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ship-pr

README.md
[![agentmods](https://agentmods.dev/badge/skills/nikeyes/stepwise-dev/ship-pr/github.svg)](https://agentmods.dev/skills/nikeyes/stepwise-dev/ship-pr)
Your own site
<a href="https://agentmods.dev/skills/nikeyes/stepwise-dev/ship-pr"><img src="https://agentmods.dev/badge/skills/nikeyes/stepwise-dev/ship-pr/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for ship-pr

Your own site · 80×15
<a href="https://agentmods.dev/skills/nikeyes/stepwise-dev/ship-pr"><img src="https://agentmods.dev/badge/skills/nikeyes/stepwise-dev/ship-pr.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 53 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,135 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00053 $0.01135
Opus 5.5 $0.00021 $0.00454
Sonnet 5.5 $0.00011 $0.00227
Haiku 4.5 $0.00005 $0.00113

Measured 8d ago against content hash a4fee926232b, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

ship-pr scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

git/skills/ship-pr/SKILL.md · 99 lines

How it starts

The opening of the file, as written. The whole thing — 99 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Ship PR

Take the work in this repository to a pull request that is ready to merge: commit it, push it, open the PR, wait for its checks, fix what fails and answer the review comments.

Nobody will answer questions while you run. Do not ask for confirmation at any step: the report you write at the end is the user's control point. Never merge the PR and never force-push.

Your Role: Orchestrator

You coordinate; the delegated skills do the work and own their rules. Invoke each one with the Skill tool:

  • /stepwise-git:commit creates the commits
  • /stepwise-git:open-pr pushes, opens the PR and waits for the checks
  • /stepwise-git:review-pr-comments decides on the comments, implements, pushes and replies
  • /stepwise-core:tdd fixes behavior test-first, when it is available

If a delegated skill fails, stop and report what happened. Do not work around it by doing its job yourself.

Getting Started

  • Plan: if a plan file is given, pass it to tdd and to review-pr-comments as context. Do not look for one yourself.
  • Nothing to ship: if the working tree is clean, the branch has no commits ahead of the default branch and it has no open PR, say so and stop.
  • Branch first: if you are on the default branch and there are changes to commit, create type/short-description with git switch -c before committing.
  • Commit: if there are uncommitted changes, invoke /stepwise-git:commit.

Then run the round cycle. Keep a count of fix rounds, starting at 0.

Round Cycle

Step 1 — Push and wait

Invoke /stepwise-git:open-pr. It pushes whatever is not on the remote yet, so the fixes of the previous round are verified here.

Stop with timeout if checks are still pending when it returns.

Stop with round limit if the fix-round count is 3. The comments that arrived after the last push have not been processed: say so in the report.

Step 2 — Fix the failed checks

Skip this step if no check failed.

Stop with no progress if a check fails with the same error as in the previous round.

Read the full file on GitHub · 99 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 99 lines · 53 tokens per session scan A a4fee926232b

Subscribe to this mod's changes

ship-pr is a skill published in the GitHub repository nikeyes/stepwise-dev (24 stars, last pushed 6d ago), licensed Apache-2.0. It adds 53 tokens to every session and 1,135 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-11.