Agent skill

Ship PR

by pedronauck in pedronauck/skills

Deliver implementation-complete work with impact/docs checks, release notes, commits, and a PR; optionally watch CodeRabbit.

No licenceAuto-check passedDevelopment

Install Ship PR

skills CLI
$ npx skills add pedronauck/skills --skill ship-pr -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pedronauck/skills ship-pr --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pedronauck/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/mine/ship-pr .claude/skills/ship-pr && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ship-pr
GitHub stars
634
Token cost
~720 tokens
SKILL.md length
330 words
Files
8 (incl. scripts, references)
Skills in repo
65
Repo updated
First seen
Licence
None found

At a glance

Deliver implementation-complete work with impact/docs checks, release notes, commits, and a PR; optionally watch CodeRabbit.

  • Works in 7 steps: Inspect branch/base, staged and unstaged… → Trace changed public behavior to its… → Update the affected artifacts. Follow… → …
  • Tasks that involve Changelog and release notes
  • Runs Shell scripts from its folder; calls bash

What it does

Ship PR is an agent skill from pedronauck/skills. Deliver implementation-complete work with impact/docs checks, release notes, commits, and a PR; optionally watch CodeRabbit. Excludes unfinished checkpoints, draft-only PRs, merged-PR amendments, and release publication.

Its SKILL.md is about 720 tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including scripts and reference files (for example `references/coderabbit-watch.md`, `references/commit-conventions.md` and `references/explore-impact.md`).

It sits in Development, covering Changelog and release notes. The repository describes itself as: My personal favorite skills.

When your agent uses it

  • Tasks that involve Changelog and release notes

Example prompts

  • “/ship-pr”

Requirements

  • A Bash shell

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Inspect branch/base, staged and unstaged changes, relevant instructions, PR template, and current verification. Already-committed work is…
  2. Trace changed public behavior to its affected documentation, examples, config, and release notes. A focused diff can be inspected locally…
  3. Update the affected artifacts. Follow repository release-note policy; a binary on PATH does not establish repository adoption. Group…
  4. Write a PR description around the resulting behavior, material risks, and actual validation. Use the repository template; omit empty…
  5. Before committing, run required scoped gates or reuse valid evidence as project policy allows. Stage owned paths explicitly and inspect…
  6. When commit/push/PR creation is within the user's request, publish the feature branch and create or update its PR with gh using a body…
  7. Start an external review watcher only when requested or already part of the authorized delivery workflow. Confirm the installed command…

What it can do on your machine

Read from SKILL.md and the folder at commit 0422940. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • bash

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ship PR loads about 720 tokens when it runs, and up to ~6.2k if it reads all its reference files. Until then it costs about 57 tokens; SKILL.md has 330 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~57
When it runs · the whole SKILL.md, loaded when a task matches
~720
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 330 words (~720 tokens).

“Finish the requested delivery scope using the repository's conventions. Reuse the implementation's impact analysis, current checks, and QA evidence. Do not turn preparing a PR into a release or automated review campaign unless requested or required by the project.”

— opening of SKILL.md by pedronauck
name
ship-pr
disable-model-invocation
true
metadata.author
Pedro Nauck
metadata.github
https://github.com/pedronauck
metadata.repository
https://github.com/pedronauck/skills

Read the full SKILL.md on GitHub

Files

SKILL.md and 7 other files (scripts, references) in skills/mine/ship-pr of pedronauck/skills.

  • SKILL.md
  • references/coderabbit-watch.md
  • references/commit-conventions.md
  • references/explore-impact.md
  • references/pr-description.md
  • references/qa-artifacts.md
  • references/release-notes.md
  • scripts/detect-tooling.sh

Open the folder on GitHubat commit 0422940

Compare with similar skills

Ship PR next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ship PR compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ship PR this skillpedronauck/skills634—~720Automated safety check: PassNone
Simple Englishmoeru-ai/airi50k2 repos~4.6kAutomated safety check: PassMIT
StarRocks Release NotesStarRocks/starrocks12k—~1.9kAutomated safety check: NotesApache-2.0
Cutting A ReleaseTriliumNext/Trilium38k—~3.2kAutomated safety check: PassAGPL-3.0
React Router Release Notes Prepremix-run/react-router57k—~1.1kAutomated safety check: PassMIT
Mole CLI Release Flowtw93/Mole70k—~2.6kAutomated safety check: PassGPL-3.0

Similar skills

  • Simple English

    moeru-ai/airi

    Write or rewrite technical text with the rules of ASD-STE100 Simplified Technical English so it is clear, unambiguous, and free of AI slop.

    50k GitHub starsUsed in 2 repos~4.6k tokens
    DevelopmentAuto-check passed
  • StarRocks Release Notes

    StarRocks/starrocks

    Drafts English release notes for a StarRocks patch release from the PRs merged into its release branch, then opens a documentation PR and hands translation to /translate.

    12k GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-check: notes
  • Cutting A Release

    TriliumNext/Trilium

    A skill your agent uses when cutting, preparing, or debugging a Trilium release — bumping the monorepo version, tagging, or diagnosing a failed "Release" workflow run.

    38k GitHub stars~3.2k tokensUpdated today
    DevelopmentAuto-check passed
  • React Router Release Notes Prep

    remix-run/react-router

    Polishes pending React Router change files before the versioning scripts run, and decides whether a long-form What's Changed section is warranted.

    57k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Runbook for assessing and executing a Mole CLI release: distribution channels, pre-flight checks, capital-V tags, build artifacts and the handoff to curated release notes.

    70k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Release

    PrefectHQ/fastmcp

    Cut a FastMCP release end to end. An agent skill from PrefectHQ/fastmcp.

    28k GitHub stars~2.9k tokensUpdated today
    DevelopmentAuto-check passed

More from pedronauck/skills

All 65 skills in this repo
  • Deep Review

    pedronauck/skills

    Review branch diffs, working trees, or PRs in depth with defect, polish and cross-contract coverage.

    634 GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • Yc Apply

    pedronauck/skills

    Prepare, review, and package Y Combinator application answers and founder-video notes using the live form and verified founder facts.

    634 GitHub stars~1.3k tokensUpdated 24 days ago
    Auto-check passed
  • Guide technical communication for software developers. An agent skill from pedronauck/skills.

    634 GitHub starsUsed in 3 repos~2.3k tokens
    Auto-check passed
  • Tauri V2

    pedronauck/skills

    Tauri v2+ cross-platform app development with Rust backend. An agent skill from pedronauck/skills.

    634 GitHub starsUsed in 2 repos~4.1k tokens
    Auto-check passed
  • Hormozi Ad Factory

    pedronauck/skills

    Generates 150-750+ ad variations using Alex Hormozi's combinatorial Hook x Meat x CTA framework.

    634 GitHub stars~2.1k tokensUpdated 24 days ago
    Auto-check passed
  • Yt Master

    pedronauck/skills

    Plans and improves YouTube ideas, titles, thumbnail concepts, scripts, retention, channel strategy, and metric-based diagnosis.

    634 GitHub stars~736 tokensUpdated 24 days ago
    Auto-check passed

Categories

Questions about Ship PR

What does Ship PR do?

Deliver implementation-complete work with impact/docs checks, release notes, commits, and a PR; optionally watch CodeRabbit. Ship PR is an agent skill from pedronauck/skills. Deliver implementation-complete work with impact/docs checks, release notes, commits, and a PR; optionally watch CodeRabbit.

When should I use Ship PR?

Ship PR fits situations like: tasks that involve Changelog and release notes.

How do I install Ship PR in Claude Code?

Run `npx skills add pedronauck/skills --skill ship-pr -a claude-code`. Or copy the skill folder (skills/mine/ship-pr in pedronauck/skills) into .claude/skills/ship-pr in your project. Claude Code loads it when a task matches its description.

How do I install Ship PR in Codex?

Run `npx skills add pedronauck/skills --skill ship-pr -a codex`. Or copy the skill folder (skills/mine/ship-pr in pedronauck/skills) into .agents/skills/ship-pr in your project. Codex loads it when a task matches its description.

Can I use Ship PR in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pedronauck/skills --skill ship-pr -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ship-pr, .gemini/skills/ship-pr, .github/skills/ship-pr and .opencode/skills/ship-pr in your project.

What does Ship PR need to run?

Going by SKILL.md and its folder, Ship PR needs a shell for the scripts in its folder and the command-line tools its instructions call (bash). Our summary lists: A Bash shell.

Does Ship PR access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Ship PR safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Ship PR use?

No licence was found for Ship PR or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Ship PR use?

About 720 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.5k tokens, read only when the agent opens those files.

What are the alternatives to Ship PR?

Skills that share tags, products or a category with Ship PR: Simple English (moeru-ai/airi, 50k stars), StarRocks Release Notes (StarRocks/starrocks, 12k stars), Cutting A Release (TriliumNext/Trilium, 38k stars) and React Router Release Notes Prep (remix-run/react-router, 57k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ship PR?

pedronauck (a GitHub user) maintains it in pedronauck/skills, which has 634 GitHub stars. The repository holds 65 skills in this directory. The repository was last updated on September 14, 2026.

Source: pedronauck/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.