Skip to content

Code-review skill for pre-push self-review of correctness, data-flow, and test gaps#3

Open
prateekkathal wants to merge 1 commit into
mainfrom
chore/code-review-skill
Open

Code-review skill for pre-push self-review of correctness, data-flow, and test gaps#3
prateekkathal wants to merge 1 commit into
mainfrom
chore/code-review-skill

Conversation

@prateekkathal

@prateekkathal prateekkathal commented Jun 26, 2026

Copy link
Copy Markdown
Member

Summary

Adds a new code-review skill: a pre-push self-review you run on your own changes before they go out. It reviews the working diff or branch-vs-base for correctness, data-flow, concurrency, and consistency bugs, and surfaces test gaps.

Changes

  • code-review/SKILL.md — the review process: correctness passes ordered by yield, a test-gap pass, a precision filter to avoid false positives, and a structured output format.
  • code-review/references/bug-catalog.md — a scannable 60-second checklist plus a frequency-ranked class index and false-positive patterns.
  • Root CLAUDE.md referencing AGENTS.md, with the repo's public/generic working rule.
  • README.md — add code-review to the skills table and the single-skill install example.
  • .gitignore — keep local-only tooling and data under code-review/ out of the repo.

Notes

Committed content is generic per the repo's public-use convention. The skill's correctness lens complements the existing github-pr-review skill (self-review of your own diff vs. reviewing someone else's PR).


Note

Low Risk
Documentation-only skill and README/metadata changes; no application runtime or security-sensitive code paths.

Overview
Adds a new code-review agent skill for pre-push self-review of your own diff (uncommitted, branch-vs-base, or gh pr diff), positioned as the complement to github-pr-review (collaborative review of someone else’s PR).

code-review/SKILL.md defines the workflow: how to pick the diff and base branch, read beyond hunks, a quality bar (DRY/consistency), correctness passes A–J (producer–consumer tracing, queue idempotency, failure paths, TypeORM null vs undefined, React cache/hooks, SQL/migrations, Nest wiring, security), mandatory test-gap analysis, a precision filter for false positives, and structured output (push verdict + 🔴/🟠/🟡/🔵 findings).

code-review/references/bug-catalog.md mirrors that content as a 60-second checklist, frequency-ranked bug classes, and false-positive patterns.

Repo hygiene: CLAUDE.md documents public/generic contribution rules and points at AGENTS.md; README.md lists the skill and adds a single-skill install line; .gitignore excludes local code-review/scripts/ and code-review/examples/ so only distilled skill content is published.

Reviewed by Cursor Bugbot for commit 98b5f65. Bugbot is set up for automated code reviews on this repo. Configure here.

A self-review skill for your own changes before pushing — reviews the
working diff or branch-vs-base for correctness, data-flow, concurrency,
and consistency bugs, and flags test gaps.

- code-review/SKILL.md: the review passes (ordered by yield), test-gap
  pass, precision filter, and structured output format
- code-review/references/bug-catalog.md: scannable checklist + class index
- Add root CLAUDE.md referencing AGENTS.md
- README: add code-review to the skills table and single-skill install
- gitignore local-only tooling/data under code-review/
@prateekkathal prateekkathal self-assigned this Jun 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant