Agent skill

review-correctness

Analyze code for bugs and correctness problems using strict determination criteria. Returns structured findings without applying fixes. Use when the user asks to "review correctness", "scan my code for bugs", "find bugs in my changes", "look for bugs", "check for bugs", or "run a correctness review".

Stars 261
Forks 21

Install this agent skill to your Project

npx add-skill https://github.com/tobihagemann/turbo/tree/main/skills/review-correctness

SKILL.md

Review Correctness

Analyze code for bugs and correctness problems. Return structured findings.

Step 1: Determine the Scope

Determine what to review:

  • If a specific diff command was provided (e.g., git diff --cached, git diff main...HEAD), use that.
  • If a file list or directory was provided, review those files directly (read the full files, not a diff).
  • If neither was provided, default to diffing against the repository's default branch (detect via gh repo view --json defaultBranchRef --jq '.defaultBranchRef.name').

Step 2: Review

  1. For diff scope: run the diff command to obtain the changes. For file scope: read the specified files.
  2. For each file, read enough surrounding context to understand the code
  3. Apply the bug determination criteria and return findings in the output format below

Bug Determination Criteria

Flag an issue only when ALL of these hold:

  1. It meaningfully impacts the accuracy, performance, security, or maintainability of the code
  2. The bug is discrete and actionable (not a general codebase issue or combination of multiple issues)
  3. Fixing it does not demand rigor beyond what exists in the rest of the codebase
  4. In diff mode: the bug was introduced in the changeset (do not flag pre-existing bugs). In file scope mode: this criterion does not apply
  5. The author would likely fix the issue if aware of it
  6. The bug does not rely on unstated assumptions about the codebase or author's intent
  7. Speculation is insufficient — identify the parts of the code that are provably affected
  8. The issue is clearly not an intentional change by the original author

Comment Standards

  1. Be clear about why the issue is a bug
  2. Communicate severity accurately — do not overstate
  3. Keep the body to one paragraph maximum
  4. No code chunks longer than 3 lines. Use markdown inline code or code blocks
  5. Explicitly communicate the scenarios, environments, or inputs needed for the bug to arise
  6. Use a matter-of-fact tone, not accusatory or overly positive
  7. Write so the author can immediately grasp the idea without close reading
  8. No flattery ("Great job...", "Thanks for...")

Priority Levels

  • P0 — Drop everything. Blocking release or operations. Only for universal issues that do not depend on assumptions about inputs
  • P1 — Urgent. Should be addressed in the next cycle
  • P2 — Normal. To be fixed eventually
  • P3 — Low. Nice to have

What to Ignore

  • Trivial style unless it obscures meaning or violates documented standards
  • In diff mode: pre-existing issues not introduced by this changeset

Output Format

Return findings as a numbered list. For each finding:

### [P<N>] <title (imperative, ≤80 chars)>

**File:** `<file path>` (lines <start>-<end>)

<one paragraph explaining why this is a bug, what scenarios trigger it, and the impact>

After all findings, add:

## Overall Verdict

**Correctness:** <correct | incorrect>

<1-3 sentence explanation>

If there are no qualifying findings, state that the code looks correct and explain briefly.

Expand your agent's capabilities with these related and highly-rated skills.

tobihagemann/turbo

review-api-usage

Check API, library, and framework usage in code against official documentation and installed skill knowledge. Flags deprecated APIs, incorrect method signatures, wrong parameter types, version-incompatible patterns, and best-practice violations. Use when the user asks to "review API usage", "check API usage", "verify against docs", "check library usage", "validate API calls", "check against documentation", or "check for deprecated APIs".

261 21
Explore
tobihagemann/turbo

resolve-pr-comments

Evaluate, fix, answer, and reply to GitHub pull request review comments. Handles both change requests (fix or skip) and reviewer questions (explain using reasoning recalled from past Claude Code transcripts). Use when the user asks to "resolve PR comments", "fix review comments", "address PR feedback", "handle review comments", "address review feedback", "respond to PR comments", "answer review questions", or "address code review".

261 21
Explore
tobihagemann/turbo

consult-codex

Multi-turn consultation with Codex CLI for second opinions, brainstorming, or collaborative problem-solving. Use when the user asks to "consult codex", "ask codex", "get codex's opinion", "brainstorm with codex", "discuss with codex", or "chat with codex".

261 21
Explore
tobihagemann/turbo

review-tooling

Detect what dev tooling infrastructure a project has and flag gaps across linters, formatters, pre-commit hooks, test runners, and CI/CD pipelines. Returns structured findings without applying changes. Use when the user asks to "review tooling", "check project tooling", "what tooling is missing", "review dev infrastructure", or "tooling audit".

261 21
Explore
tobihagemann/turbo

create-changelog

Create a CHANGELOG.md following keepachangelog.com conventions with version history backfilled from GitHub releases or git tags. Use when the user asks to "create a changelog", "add a changelog", "initialize changelog", "start a changelog", "set up changelog", "generate changelog", or "backfill changelog".

261 21
Explore
tobihagemann/turbo

update-changelog

Update the Unreleased section of CHANGELOG.md based on current changes. No-op if CHANGELOG.md does not exist. Use when the user asks to "update changelog", "add to changelog", "update the changelog", "changelog entry", "add changelog entry", or "log this change".

261 21
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results