Agent skill

PR Health

by shepherdjerred in shepherdjerred/monorepo

Inspect a PR's merge conflicts, current CI, review status, and next steps.

GPL-3.0Auto-check passedDevelopment

Install PR Health

skills CLI
$ npx skills add shepherdjerred/monorepo --skill pr-health -a claude-code

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

GitHub CLI
$ gh skill install shepherdjerred/monorepo pr-health --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/shepherdjerred/monorepo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/dotfiles/dot_agents/skills/pr-health .claude/skills/pr-health && 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
pr-health
GitHub stars
112
Token cost
~315 tokens
SKILL.md length
136 words
Files
1
Skills in repo
63
Repo updated
First seen
Licence
GPL-3.0

At a glance

Inspect a PR's merge conflicts, current CI, review status, and next steps.

  • A one-shot health check
  • Calls gh
  • Use pr-monitor for an ongoing wait

What it does

PR Health is an agent skill from shepherdjerred/monorepo. Inspect a PR's merge conflicts, current CI, review status, and next steps. Use for a one-shot health check; use pr-monitor for an ongoing wait.

Its SKILL.md is about 320 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Git workflow. The repository describes itself as: Monorepo for all of my projects. The licence is GPL-3.0.

When your agent uses it

  • A one-shot health check
  • Use pr-monitor for an ongoing wait

Example prompts

  • “/pr-health”

What it can do on your machine

Read from SKILL.md and the folder at commit d66c497. 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

    Shell commands in SKILL.md call:

    • gh

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

  • Network

    No URLs in SKILL.md. Its commands use gh, which can reach the network depending on how they are called.

    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

PR Health loads about 315 tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 136 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~38
When it runs · the whole SKILL.md, loaded when a task matches
~315

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from shepherdjerred/monorepo at commit d66c497, republished under its GPL-3.0 licence (© shepherdjerred). 136 words, ~315 tokens.

Download SKILL.mdSave it as .claude/skills/pr-health/SKILL.md (or your agent's skills folder).
name
pr-health
description
Inspect a PR's merge conflicts, current CI, review status, and next steps. Use for a one-shot health check; use pr-monitor for an ongoing wait.

PR health

In shepherdjerred/monorepo, load monorepo-delivery for delivery constraints and use the installed toolkit:

bash
toolkit pr health [PR] --json
toolkit ci explain [PR] --json
toolkit pr review list [PR] --json

Omit the PR number to infer the current branch. Health combines local merge-tree, exact-head Woodpecker CI, and GitHub metadata. Woodpecker's current pipeline is authoritative when GitHub summaries lag. The report and ci explain provide commands for deeper logs; use those rather than obsolete pr logs or pr detect commands.

Toolkit resolves registered credentials automatically. Authentication setup, exit codes, and the separate CI credential path live in packages/toolkit/README.md. Report pending work separately from failures and state which acceptance layers were checked. A health check does not authorize creating or merging a PR.

For other repositories, inspect the selected PR with native gh pr view and gh pr checks, then use that repository's CI provider for logs. Follow its delivery guidance before making changes.

© shepherdjerred, GPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in packages/dotfiles/dot_agents/skills/pr-health of shepherdjerred/monorepo.

Open the folder on GitHubat commit d66c497

Compare with similar skills

PR Health 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.

PR Health compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
PR Health this skillshepherdjerred/monorepo112—~315Automated safety check: PassGPL-3.0
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
Code Design Rationale Investigatorcursor/plugins11k9 repos~2.6kAutomated safety check: PassNone
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT
Migrate Internal Package into GhostTryGhost/Ghost56k—~3.8kAutomated safety check: PassMIT
Create Pull Requestcline/cline70k1 repos~1.6kAutomated safety check: PassApache-2.0

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    11k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed
  • Moves a package from another TryGhost repository into Ghost as an internal workspace package while keeping its Git history, with checkpoints for the steps that need an administrator.

    56k GitHub stars~3.8k tokensUpdated today
    DevelopmentAuto-check passed
  • Opens a GitHub pull request from your current branch with the gh CLI, after reviewing the commits and diff and gathering the details the PR needs.

    70k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed
  • Writes Conventional Commits whose bodies carry action lines recording the intent, decisions and constraints behind a change, not only what changed.

    29k GitHub starsUsed in 1 repo~2.7k tokens
    DevelopmentAuto-check passed

More from shepherdjerred/monorepo

All 63 skills in this repo
  • Bun Runtime Best Practices

    shepherdjerred/monorepo

    Bun runtime APIs and current operational patterns for files, processes, modules, networking, databases, tests, and deployment.

    112 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Bun Test Patterns

    shepherdjerred/monorepo

    Current Bun test runner guidance for discovery, isolation, parallelism, sharding, changed tests, mocks, timers, snapshots, coverage, DOM Testing Library, and integration teardown.

    112 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Bun Workspaces

    shepherdjerred/monorepo

    Current Bun workspace guidance for isolated and hoisted linkers, catalogs, filters, scripts, dependency classes, lockfiles, lifecycle trust, caches, publishing, TypeScript package exports, and…

    112 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Deep Research

    shepherdjerred/monorepo

    This skill should be used when the user asks to "deep research", "research this topic", "investigate thoroughly", "do a deep dive on", "comprehensive research on", "find everything about", "survey…

    112 GitHub stars~4.7k tokensUpdated today
    Auto-check: notes
  • Figma Use

    shepherdjerred/monorepo

    This skill should be used when the user asks to "create a Figma design", "design in Figma", "make a Figma mockup", "create an app icon", "design UI", "render JSX to Figma", "export from Figma"…

    112 GitHub stars~946 tokensUpdated today
    Auto-check passed
  • Fish Helper

    shepherdjerred/monorepo

    Current Fish shell scripting, functions, abbreviations, completions, variables, events, configuration, plugins, testing, and safety guidance.

    112 GitHub stars~2k tokensUpdated today
    Auto-check passed

Categories

Questions about PR Health

What does PR Health do?

Inspect a PR's merge conflicts, current CI, review status, and next steps. PR Health is an agent skill from shepherdjerred/monorepo. Inspect a PR's merge conflicts, current CI, review status, and next steps.

When should I use PR Health?

PR Health fits situations like: A one-shot health check; use pr-monitor for an ongoing wait.

How do I install PR Health in Claude Code?

Run `npx skills add shepherdjerred/monorepo --skill pr-health -a claude-code`. Or copy the skill folder (packages/dotfiles/dot_agents/skills/pr-health in shepherdjerred/monorepo) into .claude/skills/pr-health in your project. Claude Code loads it when a task matches its description.

How do I install PR Health in Codex?

Run `npx skills add shepherdjerred/monorepo --skill pr-health -a codex`. Or copy the skill folder (packages/dotfiles/dot_agents/skills/pr-health in shepherdjerred/monorepo) into .agents/skills/pr-health in your project. Codex loads it when a task matches its description.

Can I use PR Health 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 shepherdjerred/monorepo --skill pr-health -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pr-health, .gemini/skills/pr-health, .github/skills/pr-health and .opencode/skills/pr-health in your project.

What does PR Health need to run?

Going by SKILL.md and its folder, PR Health needs the command-line tools its instructions call (gh).

Does PR Health access the network?

SKILL.md contains no URLs. Its commands use gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is PR Health 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. Review the folder before installing.

What licence does PR Health use?

PR Health is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does PR Health use?

About 315 tokens (SKILL.md is roughly 1.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to PR Health?

Skills that share tags, products or a category with PR Health: Finishing a Development Branch (obra/superpowers, 297k stars), Code Design Rationale Investigator (cursor/plugins, 11k stars), Contributor-First PR Merge (HKUDS/OpenHarness, 16k stars) and Migrate Internal Package into Ghost (TryGhost/Ghost, 56k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains PR Health?

shepherdjerred (a GitHub user) maintains it in shepherdjerred/monorepo, which has 112 GitHub stars. The repository holds 63 skills in this directory. The repository was last updated on October 10, 2026.

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