Skip to content
Skills Library
Programming · Review & audit

code-review

/code-review

Reviews pull requests and code changes for correctness, conventions, maintainability, performance, test coverage, and security. Use when the user asks for a code review, PR review, feedback on a diff, or to check code quality.

Licence
MIT
Last repository change
20.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 20.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Reviews pull requests and code changes for correctness, conventions, maintainability, performance, test coverage, and security. Use when the user asks for a code review, PR review, feedback on a diff, or to check code quality.

Original author description

Reviews pull requests and code changes for correctness, conventions, maintainability, performance, test coverage, and security. Use when the user asks for a code review, PR review, feedback on a diff, or to check code quality.

How it works

  1. Workflow
  2. Constraints
Original SKILL.md headings · 103 lines, 588 words
SKILL.md preview
---
name: code-review
description: Reviews pull requests and code changes for correctness, conventions, maintainability, performance, test coverage, and security. Use when the user asks for a code review, PR review, feedback on a diff, or to check code quality.
---

# Code Review

Target: `$ARGUMENTS` (optional PR number, branch, path, or diff scope)

## Workflow

Progress checklist:

```
Code Review:
- [ ] Step 1: Identify review target
- [ ] Step 2: Gather change context
- [ ] Step 3: Evaluate the change
- [ ] Step 4: Separate findings from noise
- [ ] Step 5: Deliver findings-first review
```

### Step 1: Identify Review Target

- If `$ARGUMENTS` is empty and the request is about a PR, run `gh pr list` to show open PRs, then ask the user which PR to review.
- If `$ARGUMENTS` looks like a PR number, run `gh pr view <number>` to capture the title, status, base branch, head branch, and summary.
- Otherwise treat the target as local changes, a branch, a commit range, or a file path.

### Step 2: Gather Change Context

- For PR review, run `gh pr diff <number>`.
- For local review, inspect `git diff`, `git diff --staged`, or the diff for the requested range.
- Read the changed files with surrounding context. Do not review the raw diff in isolation.
- Identify the scope: feature, bug fix, refactor, test, docs, or mixed.
- If `gh` is unavailable or unauthenticated, say so clearly and fall back to the available local diff.

### Step 3: Evaluate the Change

Review for:

- **Correctness** — edge cases, null or empty inputs, error handling, stale state, off-by-one logic, async races, retries, cancellation, and timeouts.
- **Maintainability** — naming, duplication, single responsibility, magic values, avoidable complexity, and consistency with nearby code.
- **Performance** — N+1 queries, repeated expensive work, render-loop costs, unnecessary allocations, and over- or under-used memoization.
- **Type safety** — missing narrowing, unchecked unions, overly broad types, and unclear public API return types.
- **Testing** — coverage for happy paths, failure paths, and the most likely regression cases.
- **Security** — auth gaps, injection risks, secret handling, unsafe parsing, XSS, SSRF, or CSRF when relevant.

### Step 4: Separate Findings from Noise

- Flag only issues with real impact on correctness, risk, maintainability, performance, or test confidence.
- Do not bikeshed on formatting or linter-owned style.
- Prefer concrete evidence from the diff and surrounding code over speculation.
- If intent is ambiguous, frame it as a question or risk instead of overstating certainty.

### Step 5: Deliver Findings-First Review

Present findings first, ordered by severity:

- **Must fix** — bugs, security issues, data loss, broken behavior, merge blockers.
- **Should fix** — maintainability issues, meaningful performance problems, missing tests, or convention drift with real cost.
- **Nit** — optional minor suggestions.

For each finding include:

- `file`
- `line` or nearest symbol
- the issue
- why it matters
- a suggested fix

Then include:

1. A short overview of what the change does.
2. Good decisions worth keeping.
3. Residual risks or test gaps.

If no actionable findings remain, say so explicitly and mention any remaining uncertainty.

Use this response shape:

```markdown
## Must fix
- `path/to/file:line` Issue. Why it matters. Suggested fix.

## Should fix
- None.

## Nit
- None.

## Overview
- Brief summary of the change.

## What looks good
- Specific strengths.

## Residual risks
- Missing test coverage, assumptions, or things not verified.
```

## Constraints

- Findings first. Keep the summary brief.
- Be constructive and specific.
- Follow project conventions by reading adjacent code, tests, and config before flagging style issues.
- Do not invent missing context; say what you verified and what you could not verify.

Versions

RepositoryScoreLicence
This page · agentic-dev3o/devx-plugins100MIT
microsoft/aspire100MIT
kdlbs/kandev100AGPL-3.0
dotnet/runtime100MIT
drosam/agents100MIT
ggml-org/llama.cpp100MIT
ShamelesAbyss/Nyx100Apache-2.0
dzhng/jevgrep100MIT
iuliandita/skills100MIT

Database snapshot: 13.11.2026 · package version f0060ffc404d (SHA-256 digest of the entire package)

Downloads in the last 30 days: 1 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100audit-code-review
    Review a PR or diff for correctness, security, and maintainability. Use for a pull request, a named change set, or "review my changes". Repo-wide anti-patterns → audit-code-quality. Bulk transforms → audit-codemod-safety.
  • 100pr-review
    Review PyTorch pull requests for code quality, test coverage, security, and backward compatibility. Use when reviewing PRs, when asked to review code changes, or when the user mentions "review PR", "code review", or "check this PR".
  • 100pr-review
    Review PyTorch pull requests for code quality, test coverage, security, and backward compatibility. Use when reviewing PRs, when asked to review code changes, or when the user mentions "review PR", "code review", or "check this PR".
  • 90review-pr
    Performs a comprehensive pull request code review covering correctness, security, performance, test coverage, and coding standards. Use when reviewing any code changes before merge.
  • 90kodawari
    Review software with careful attention to correctness, maintainability, security, operations, and meaningful detail. Use for diffs, branches, pull requests, architecture decisions, or final quality checks.
  • 100review-pr
    Review a pull request for correctness, architecture, security, and test coverage. Use when the user names a PR number to review.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.