review-code

Reviews your own git diff against repository conventions and returns must, imo, and nits findings in conversation.

Updated Dec 25, 2021
One-click install
npx skills add https://github.com/kotahashihama/dotfiles --skill review-code-kotahashihama
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-code
Source: https://github.com/kotahashihama/dotfiles/tree/main/home/.claude/skills/review-code
Command: npx skills add https://github.com/kotahashihama/dotfiles --skill review-code-kotahashihama

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Self-reviewing your own code changes is easy to skip or do superficially, and generic review feedback often ignores the specific conventions and architectural boundaries of the repository you are working in. This Skill reviews your diff against the repository's actual rules documents and returns prioritized, evidence-backed findings without posting anything to GitHub. ## Core Features & Use Cases - Convention-grounded review: Locates and reads the repository's own rules (CLAUDE.md, .claude/rules/, docs/, lint configs) and cites them as the basis for findings instead of relying on memory. - Three-tier severity: Classifies every finding as must (merge blocker), imo (improvement suggestion), or nits (trivial), with mandatory verification before anything is raised to must. - Scoped diff analysis: Defaults to the three-dot range origin/HEAD...HEAD, excludes generated files, lockfiles, and vendored code, and defers comment-style and test-coverage concerns to dedicated sibling skills. - Use Case: Before opening a pull request, ask for a self-review of your branch. The Skill reads the repo's conventions, checks boundary violations, complexity, and failure scenarios, and returns a structured report with a fix checklist. ## Quick Start Review my current branch changes against this repository's conventions and give me must, imo, and nits feedback.

Frequently Asked Questions about review-code

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I self-review my code changes before opening a pull request?

Run the review on your branch diff, which defaults to the three-dot range origin/HEAD...HEAD. The Skill reads the repository's convention files, checks boundary violations, complexity, and failure scenarios, then returns findings grouped as must, imo, and nits with a fix checklist.

What is the difference between two-dot and three-dot git diff for code review?

Two-dot diff compares branch tips directly, so commits that landed on the base branch appear as reversed changes and pollute the review. Three-dot diff starts from the merge base, so base-branch progress never contaminates the changes under review.

Does this code review post comments to GitHub pull requests?

No, findings are returned only in the conversation and nothing is posted to GitHub. Reviewing other people's pull requests with posting is handled by the separate /review-pr skill.

How are must-level review findings verified before being reported?

Every must finding requires evidence: either the cited convention file is read and the exact passage confirmed, or the failure path is traced through actual code from input to the breaking line. Without that backing, the finding is downgraded to imo.

When should I use a multi-perspective parallel code review instead?

Use the parallel variant /review-code-deeply when a change is large or risky enough to warrant multiple simultaneous review perspectives. It reuses this Skill's severity table and output format while adding its own phase structure for splitting the work.