verify-before-pr
Skill1 starsChanged 3 days agoMITView on GitHub
Use before opening a PR, pushing, or calling a coding task done. It runs the real checks and each issue's done-when tests, trims the diff, and has the PR description written.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- MCPJam/inspectortheir own version, first seen Oct 13, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- MCPJam/inspector★ 2.3ksame name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository14 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- address-review-findingsSkill
- git-messagesSkill
- heroui-reactSkill
- model-rolesSkill
- principle-boundary-disciplineSkill
- principle-encode-lessons-in-structureSkill
- principle-type-system-disciplineSkill
- pr-reviewSkill
- ship-a-changeSkill
- technical-writingSkill
- typescript-best-practicesSkill
- unslopSkill
- web-uiSkill
The file
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 4 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 8
Run this after you finish a code change.
- Distinctive: line 18
Run every check on each issue's "Done when" list.
- Very specific: line 20
If the change has no issues, as with a small change that skipped ship-a-change, check it against what the user asked for instead.
- Distinctive: line 24
Use the changed behavior the way a user would.
- Distinctive: line 32
Read the full diff again. Remove dead code, debug prints, unused imports, commented-out code, and edits unrelated to the task.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Verify before PR
Run this after you finish a code change. Run it before you open a PR, push, or tell the user the work is done. Do every step.
1. Run the real checks
Find the project's checks in CLAUDE.md, package.json scripts, the Makefile, pyproject.toml, or the CI config. Run the tests, type checks, linter, and build.
Paste each command and the end of its output. Never write "tests pass" without output that shows it. If a check fails, fix it and run it again. If a check cannot run here, name it and say why.
2. Prove each issue is solved
Run every check on each issue's "Done when" list. Report each issue with its checks and what they showed. An issue whose checks don't all pass is not done.
If the change has no issues, as with a small change that skipped ship-a-change, check it against what the user asked for instead.
3. Check behavior end to end
Use the changed behavior the way a user would. Run the CLI command, call the endpoint, load the page, or run the script on sample input. Write down what you ran and what happened.
For a bug fix, reproduce the bug before the fix and show it gone after. Confirm the fix addresses the root cause.
For a UI change, use the "Verify the page" section in the web-ui skill.
4. Simplify the diff
Read the full diff again. Remove dead code, debug prints, unused imports, commented-out code, and edits unrelated to the task. Remove abstractions the change does not need yet.
Keep the change sized as the "Size and grouping" rules in ship-a-change say. If it is too big or mixes unrelated changes, propose splitting it into separate PRs. If it is too small for its own PR, batch it into the next related PR or use the direct-commit path, as ship-a-change describes.
5. Get the PR description written
Do not write the PR description yourself. Send an outline to a model-policy:coder: the changes, the check results, the risk tier, and the issues the PR solves. Tell it to follow the PR description format in the git-messages skill, to write the description to a file in the session scratchpad (a temp dir if none is named), and to report the path under "Notes". Its Risk section names the tier and how to revert. The Changes section ends with a Closes #N line for each issue the PR solves. When the task has checkpoints, a feature PR targets the checkpoint branch and leaves the Closes #N lines for the final PR from the checkpoint branch, because a Closes line in a PR into a non-default branch does not close the issue.
Set the risk tier from what the change touches. Never set it from who wrote the change. The tiers are:
- Low. Docs, copy, internal-only tools, and additive changes behind a feature flag.
- Medium. Ordinary product changes, caching, config, and prompts.
- High. Auth, billing, data migrations, CI workflow files, installers, updaters, and anything that deletes data.
The user reviews every PR into the default branch. For a high-risk change, point them to the parts that need the closest look. An agent's approval never replaces a person's.
Review the file against unslop and the diff, then give the file to the next step. Inside ship-a-change, the PR opens at step 8, after the review. Used on its own, open the PR after pr-review.
6. Report
Tell the user what changed, the check results, each issue's result, and the risk tier. Keep it short.
This skill does not review the change. Inside ship-a-change, the review comes next, once, at step 5, and lessons go into LESSONS.md only at step 7. Used on its own for a change that needs a review, run pr-review once before the PR into the default branch.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

