review-change
Skill3 starsChanged 21 days agoMITView on GitHub
Review a software change against requirements and project standards. Use for change, branch, or PR reviews. Return validated findings about bugs, security, and maintainability. Stop before remediation.
29 other projects use a version of this.
Adopted by
Most recently taken up by
- EpicGames/loretheir own version, first seen Nov 9, 2026
- SaKaNa-Y/skillstheir own version, first seen Nov 8, 2026
- Krzysztof318/MailFathomtheir own version, first seen Nov 7, 2026
- 0xdeafcafe/skillstheir own version, first seen Nov 6, 2026
- CsHeng/agent-skillstheir own version, first seen Nov 4, 2026
- Esri/calcite-design-systemtheir own version, first seen Nov 2, 2026
Used with
Projects with it also use write-runbook, incident-triage and 5 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
MaheshAwasareSkillwrite-runbook
Generate an operational runbook for a service from its code, config, and dependencies — what to do when it breaks, where to look, how to roll back, who to escalate to. Use proactively before a service goes to production, after a major incident, or when handing off operational ownership.
Also in 3 projects that use this
testified-ossSkillincident-triage
Triage production incidents with severity assessment, root cause hypothesis, impact analysis, and escalation recommendations. Use when analyzing outages, errors, or production issues.
Also in 4 projects that use this
srclightSkillrefactor-safely
This skill should be used when the user asks to "refactor", "rename", "move", "change a function signature", "extract a method", "delete unused code", "clean up", or any modification that could break callers or dependents. Provides a pre-change safety checklist using srclight's graph tools to assess blast radius before touching code.
Also in 3 projects that use this
Google CloudSkillopen-pr
Commits local changes to a new Git branch and opens a GitHub pull request through the configured GitHub MCP server. Use when proposing code changes in a new pull request. Don't use for local-only commits without a remote GitHub repository.
Also in 4 projects that use this
ShopifySkillprepare-release
Prepare the changeset-release/main branch for release by syncing version.ts files and running pnpm install
Also in 3 projects that use this
Microsoft AzureSkillrelease-notes
Author and update release notes for Azure App Configuration libraries and providers. USE FOR: write release notes, add release note entry, update release notes, draft release notes, new version release notes, format release notes. DO NOT USE FOR: generating changelogs from git history, writing internal engineering notes.
Also in 3 projects that use this
Other versions29 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 29
- ben-manes/caffeine★ 18ksame name
- EpicGames/lore★ 9.1ksame name
- maypok86/otter★ 2.7ksame name
- aquaproj/aqua-registry★ 398same name
- Esri/calcite-design-system★ 385same name
- yiming-liao/intor★ 211same name
- gtrabanco/agentic-workflow★ 23same name
- fathomise/MailFathom★ 21same name
- Krzysztof318/MailFathom★ 21same name
- Indium-AI-Labs/indium-agentkit★ 18same name
19 more not listed
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 repository8 other files it gives its agents.
- deliver-changeSkill
- implement-changeSkill
- plan-changeSkill
- publish-changeSkill
- remediate-findingsSkill
- review-prSkill
- setup-projectSkill
- verify-changeSkill
The file
We split this skill into the rules it gives an agent
3 rules. 0 are common, 3 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 25 edited versions we read keep these.
3
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 23
Run tests only under the review rules' test-execution limit.
- Distinctive: line 44
Read callers, callees, tests, and configuration beyond the diff as needed.
- Distinctive: line 68
Clean verdict: Before returning no findings, try the strongest plausible counterexample.
“Common” is measured: kept by at least 6 in 10 of the 25 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Review change
Return evidence-backed findings for one candidate. First read the contract core and the review rules.
Each tool call resends the whole context, so batch reads: read both references and the diff in one command, and the files you need to inspect in as few commands as possible.
1. Pin the candidate
- Identify the repository, requirements, governing instructions, and the diff. Record base, revision, and relevant dirty inputs. For a PR, fetch its current head. Resolve an ambiguous target before judging it.
- Missing requirements → Spec coverage gap. Code and commit messages alone do not establish intended behavior.
- Run tests only under the review rules' test-execution limit.
- Edits, commits, remote comments, thread resolution, and approval each need their own authorization.
2. Choose reviewers
One fresh reviewer covers all five axes by default. Add a focused specialist only for a material risk the change touches: security or privacy, money, schema or migrations, concurrency, or a public contract. Risk sets this, not size.
- Independence. A fresh reviewer did not author the candidate and gets neutral context. An implementer reviewing its own work delegates. No delegation → report the missing independent review.
- Delegation. Each delegate gets the same candidate identity, requirements, scope, permissions, and its assignment. It returns findings, coverage, checks, and gaps, not code summaries. Delegates must see uncommitted inputs in scope; a worktree with only HEAD is a different candidate. Use only approved delegation destinations. Run at most three reviewers at once; reviewers spawn no reviewers.
3. Inspect
Read callers, callees, tests, and configuration beyond the diff as needed.
- Standards: cite the governing project rule; separate convention from preference.
- Spec: trace requirements and exclusions through code, tests, and behavior docs; find omissions and unintended changes.
- Bugs: trace reachable failures, including retries, concurrency, and recovery; check that tests detect the defect.
- Quality: coupling, state, abstraction cost. Propose a simpler form that keeps required behavior.
- Security: trust boundaries, permissions, data exposure, and dangerous operations from reachable input to effect.
- Performance: tie each concern to a reachable workload; label predictions unmeasured.
Claims. For changed docs, comments, or messages that state facts, list each
material claim, confirmed ones included. Mark it confirmed, contradicted, or
unverified against its governing source, cited as file:line. Cite the line that
sets or enforces the value, not the start of its file or function. An uncited claim
is unverified. Group claims only when source and conclusion match. Contradictions
become findings.
Each finding. Quote the motivating file:line; a finding you cannot quote is
unverified. Compare with the base to separate regressions from pre-existing issues.
Clean verdict. Before returning no findings, try the strongest plausible counterexample. Record target, source, and result.
4. Validate and return
Validate and label findings under the review rules; votes do not decide correctness. Order by impact: critical, high, medium, low. Recommend a material redesign for decision; do not apply it. Run the contract's freshness check. Unverified freshness or coverage → review incomplete.
Return this report in your final message even when findings are also saved
elsewhere. A saved file does not change its shape. Keep all eight numbered
labels, in this order; do not merge, rename, or move them. Fill every slot;
write none when empty.
1. Candidate: base, head, dirty inputs | freshness: unchanged, refreshed, or unverified
2. Arrangement: reviewers, axes, specialists, missing coverage
3. Findings by impact, or "no findings":
label | severity | axis | location | trigger | expected vs observed | evidence | remedy
4. Claims: claim | changed location | status | source file:line
5. Coverage: axis | files or interfaces inspected | not checked
6. Checks: existing evidence | tests run | tests not run
7. Clean verdict only: counterexample | source | result
8. Open questions, gaps, next actionFictional rows:
4. "Tokens expire after 24 hours" | docs/api.md:12 | confirmed | src/auth/config.py:8
5. Security | src/auth/session.py, POST /login | rate limiting"No findings" never implies unrun checks passed. Standalone review ends here. In delivery mode, return the report to the caller.
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.

