code-review
/code-review
Review a change deeply, trace its whole-project impact, and report concrete actionable defects with evidence, severity and verification. Use for diffs, pull requests, staged work or requested repository-wide engineering assessment.
- Author
- paulocoutinhox ↗
- Repository
- skills ↗
- Licence
- MIT
- Last repository change
- 09.11.2026
Assessment and security
- Files in this package
- 7
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 3
No signals detected. Repository changed on 09.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Review a change deeply, trace its whole-project impact, and report concrete actionable defects with evidence, severity and verification. Use for diffs, pull requests, staged work or requested repository-wide engineering assessment.
Original author description
Review a change deeply, trace its whole-project impact, and report concrete actionable defects with evidence, severity and verification. Use for diffs, pull requests, staged work or requested repository-wide engineering assessment.
How it works
- Establish exactly what is reviewed
- Build the execution and impact map
- Inspect professional risk dimensions
- Worked finding and false-positive check
- Severity and validation
- Professional foundations and delivery
SKILL.md preview
--- name: code-review description: Review a change deeply, trace its whole-project impact, and report concrete actionable defects with evidence, severity and verification. Use for diffs, pull requests, staged work or requested repository-wide engineering assessment. license: MIT --- # Code Review Understand the change as a system before judging individual lines. Find defects that can occur in supported execution, explain their effect, and reject speculative noise. Unless fixes are requested, the result is an assessment rather than an unsolicited rewrite. ## Establish exactly what is reviewed Identify the task, reviewed revision, base/head or merge base, complete file list and working-tree state. Distinguish a PR branch from its integrated merge result. Distinguish staged, unstaged and untracked content. Read project instructions and acceptance criteria. Read enough surrounding implementation to identify actual entrypoints, helpers, invariants and framework wiring. A diff may omit an existing authorization check or lifecycle owner. Verify them before reporting a missing control. Generated files, deleted files, migrations, manifests and release configuration need deliberate review. ## Build the execution and impact map Start from changed inputs or contracts and trace both dependencies and consumers. Search symbols, imports, routes, event names, persisted fields, configuration keys, cache prefixes and package exports. Inspect dynamic registries/framework wiring when text search cannot establish reachability. | Change | Follow through | | --- | --- | | Return type/error | Every caller, serializer, UI error state, CLI exit status and test double | | Persisted field | Constraints, migration, reads/writes, imports, exports, jobs and indexes | | Authorization | Lists, details, mutations, files, previews, exports, websocket/jobs and caches | | Async behavior | Owner lifetime, cancellation, stale completion, shutdown and retries | | Dependency/toolchain | Runtime, peers, lockfile, native ABI, build image and shipped entrypoints | | Release | Identity, trigger trust, built artifact, final package, version and rollout | A correct local refactor can fail during deployment if other running components still consume the old event or schema. Identify the actual coordination/migration requirement without inventing a permanent compatibility layer. ## Inspect professional risk dimensions Check functionality against real normal, empty, invalid and boundary inputs. Separate a successful empty result from a suppressed failure. Look for partial mutation followed by an error reported as success. Check state and data invariants. For uniqueness, balances, stock and fulfillment, a preceding read is not sufficient protection against concurrent requests. Locate the authoritative constraint/transaction/idempotency mechanism and inspect ordering of durable writes and side effects. Check resources and lifetime. Follow file handles, streams, threads, tasks, observers, timers, native objects and lock ownership. Inspect cleanup on failure and cancellation. Avoid assuming garbage collection or async syntax proves correct lifetime. Check performance only against an actual path and scale. Explain an N+1 query, unbounded allocation, repeated expensive render or query complexity with a trigger. Do not demand caching or abstraction without demonstrated need. Check security at the authoritative boundary. A hidden button, opaque object ID or client type annotation does not authorize a server operation. Trace tenant scope into alternate routes, exports and background jobs. Check maintainability through concrete consequences. Difficult ownership or duplicated rules can cause divergent behavior, but a personal naming preference is not automatically a defect. Do not mix optional polish with release-blocking findings. ## Worked finding and false-positive check Suppose the modified download endpoint reads a report by ID and returns its file. Before reporting a cross-tenant disclosure, inspect middleware, the repository query and storage policy. If the query already derives tenant scope from trusted session context, reject the suspicion. If the actual query is unscoped, reproduce with two controlled tenants or establish the complete source path. Explain that tenant A can obtain tenant B's existing report by supplying its ID. The remedy belongs in the authoritative lookup/policy and must cover preview/export paths too. Replacing the ID with a UUID would not fix the root cause. A useful finding contains: 1. A short title identifying the actual defect. 2. Exact current location and reachable trigger. 3. Observed or source-proven behavior and user/system consequence. 4. Relevant prerequisites, affected consumers and impact scope. 5. A corrective direction and a meaningful verification case. 6. Confidence and missing evidence when applicable. Do not claim execution evidence for static reasoning. Do not duplicate one root cause into many comments. ## Severity and validation Critical means demonstrated severe broad compromise/corruption or catastrophic reachable failure. High means significant impact on an important path. Medium means meaningful bounded impact under a supported condition. Low means a concrete minor defect or explicit requirement violation. Confidence is separate from severity. Use focused existing tests, a minimal reproducer, build/type checks, isolated consumer tests or relevant native diagnostics. Distinguish baseline failures from introduced failures. Do not run destructive production tests. Recheck each finding against the final reviewed revision, including its line number. Use [the impact guide](references/impact.md), [assessment procedure](references/procedure.md), [finding guide](references/findings.md) and [report template](assets/impact-review.md) for additional detail. ## Professional foundations and delivery [Google Engineering Practices](https://google.github.io/eng-practices/review/reviewer/) provides an experienced inspection framework. The publicly available code-review chapter of [Software Engineering at Google](https://abseil.io/resources/swe-book/html/ch09.html) gives broader engineering context. Bacchelli and Bird's ICSE 2013 study, [Expectations, Outcomes, and Challenges of Modern Code Review](https://www.microsoft.com/en-us/research/publication/expectations-outcomes-and-challenges-of-modern-code-review/), supports emphasizing change understanding and knowledge transfer rather than counting comments. Its industrial observations are not a guarantee about AI review accuracy. Lead the report with actionable findings. If none were found, say so without certifying the project defect-free. State revision, covered paths, checks and limitations. When fixes were authorized, correct justified issues, validate affected consumers, and report the final state. No review bots, scanners or auto-fix machinery are bundled with this descriptive skill. See [sources](references/sources.md) and [license](LICENSE.md).
Files in this package (7)
- LICENSE.md 1 KB
- SKILL.md 7 KB
- assets/impact-review.md 1 KB
- references/findings.md 2 KB
- references/impact.md 3 KB
- references/procedure.md 3 KB
- references/sources.md 2 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · paulocoutinhox/skills | 90 | MIT |
| microsoft/aspire | 100 | MIT |
| kdlbs/kandev | 100 | AGPL-3.0 |
| dotnet/runtime | 100 | MIT |
| drosam/agents | 100 | MIT |
| ggml-org/llama.cpp | 100 | MIT |
| ShamelesAbyss/Nyx | 100 | Apache-2.0 |
| dzhng/jevgrep | 100 | MIT |
| iuliandita/skills | 100 | MIT |
Database snapshot: 13.11.2026 · package version 538f3af7e8b7 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100code-reviewer
Review a specified code change for actionable defects. Use for uncommitted changes, base-branch diffs, commits, PRs or MRs; review alone is read-only, and requested fixes follow the review. Not a repository-wide security or complexity audit. - 100mkl-review-pr
Review a pull request for concrete correctness regressions using its diff, surrounding code, and relevant tests. Use for a requested PR review; distinguish actionable defects from optional preferences. - 100mkl-review-pr
Review a pull request for concrete correctness regressions using its diff, surrounding code, and relevant tests. Use for a requested PR review; distinguish actionable defects from optional preferences. - 100project-review
Read-only bug hunt across a whole project or one folder, not just one branch. Maps the code, ranks its areas by risk (stored data and migrations first, then error paths at the edges, then the code that changes or breaks most) and reviews them one area per pass through two… - 90reviews
Review a pull request or code change for code health. Use when a user asks to "code review", "review this PR", or "review this change". - 100reviewing-code
Use when reviewing changed code, PRs, diffs, or specific files. Finds evidence-backed defects in security, correctness, tests, reliability, performance, maintainability, and docs. Supports quick, standard, deep, team, and external-review modes, plus a simplify mode for…