pr-standard

Scores pull requests against a fixed merge-readiness standard with per-row verdicts.

Updated May 5, 2026
One-click install
npx skills add https://github.com/josippapez/ai-setup --skill pr-standard-josippapez
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pr-standard
Source: https://github.com/josippapez/ai-setup/tree/main/claude/plugins/dev-core/skills/pr-standard
Command: npx skills add https://github.com/josippapez/ai-setup --skill pr-standard-josippapez

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams lack a consistent, objective bar for deciding whether a pull request is ready to merge, leading to subjective reviews, drive-by changes slipping in, and PRs merged without tests that fail on the base branch. ## Core Features & Use Cases - Fixed PR-level standard: Twelve scored properties covering single purpose, clean base, size under ~400 hand-written lines, justified hunks, tests that fail on base, dependencies, commits, and green CI on the PR head. - Structured scoring procedure: Fetches the full PR via gh pr view and gh pr diff, walks hunks rather than files, and emits a verdict line, fail list, score table, and unverified rows in a fixed output order. - Calibration workflow: Scores the last three merged PRs to reveal whether rows are stricter than the team wants when introducing the standard. - Use Case: Before opening a PR, ask whether it meets the bar; the skill checks each hunk against the title and tests, then reports exactly which rows fail with file:line evidence. ## Quick Start Ask the assistant to score the current pull request against the PR standard and report whether there is nothing to change.

Frequently Asked Questions about pr-standard

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

FAQPage Schema
How do I check if my pull request is ready to merge?

Score the PR against the twelve-row standard: one reason to exist, clean base, holdable size, justified hunks, tests failing on base, and green CI on the PR head. The PR is ready only when every applicable row passes.

How to review a PR against a fixed standard instead of hunting for bugs?

Fetch the PR with gh pr view and gh pr diff, walk hunks rather than files, and score each standard row as pass, fail, or n/a with evidence. Bug hunting belongs to a separate code-review pass; this checks whether the PR meets the merge bar.

What is the difference between PR standard scoring and code review?

Standard scoring answers whether a PR meets a fixed merge bar covering size, tests, description, and CI. Code review answers whether the code has bugs. A bug found during scoring is reported under the justified-hunks row, not investigated.

Does the 400-line PR size limit include generated files?

No. Lockfiles, generated code, snapshots, and mechanical renames are excluded from the count before comparing against roughly 400 hand-written lines. Larger work should be split by layer, such as migration, then API, then UI.

When should I not use PR standard scoring?

Do not use it to hunt for bugs, to score from the description alone without checking the diff, or to fix issues while scoring. It also does not soften a fail because a PR already merged, since the score reflects the standard, not the outcome.