local-review

Reviews local code changes through specialized read-only lenses and returns one consolidated findings report.

Updated Jul 4, 2023
One-click install
npx skills add https://github.com/kohdice/dotfiles --skill local-review-kohdice
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: local-review
Source: https://github.com/kohdice/dotfiles/tree/main/config/agents/skills/local-review
Command: npx skills add https://github.com/kohdice/dotfiles --skill local-review-kohdice

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Reviewing local changes, branches, or entire codebases before committing is time-consuming and easy to do inconsistently. This Skill orchestrates a structured, read-only review of code as it sits on disk, applying specialized review lenses and returning a single severity-grouped report without editing files, running tests, or publishing anything. ## Core Features & Use Cases - Scope-parameterized review: Resolves the review target from your request — working diff, branch diff against a base, unpushed commits, a specific path, or a whole-codebase audit with chunking. - Specialized review lenses: Selects lenses (correctness, idiom, architecture, performance, simplicity, comment, sql) based on what the change actually touches, with support for C, Go, Rust, and Zig plus SQL files. - Delegated or direct execution: Dispatches one read-only reviewer sub-agent per lens in parallel for large scopes, or runs a single direct pass for small ones, then synthesizes and deduplicates findings by root cause. - Use Case: Before pushing a feature branch, ask for a review of your changes against main; the Skill detects the languages, selects the relevant lenses, and returns one report grouping findings by High, Medium, and Low severity with proposed fixes. ## Quick Start Ask the AI to review my local changes against the main branch and report any correctness, performance, or idiom issues without modifying any files.

Frequently Asked Questions about local-review

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

FAQPage Schema
How do I review local changes before committing?▼

Ask for a review of your working diff; the Skill collects changed and untracked files via git diff and git status, selects review lenses based on what the change touches, and returns one severity-grouped findings report without modifying anything.

How to review a branch against a base branch locally?▼

Name the base branch in your request, and the Skill computes the file list with git diff <base>...HEAD, then applies the selected lenses to that diff. For unpushed commits it uses the upstream tracking branch instead.

What languages does local code review support?▼

The Skill has dedicated idiom lenses for C, Go, Rust, and Zig, plus a sql lens for .sql files, migrations, and SQL embedded in code. Files in other languages receive only the generic correctness lens.

Does the review run tests or builds to verify findings?▼

No. The Skill is strictly read-only: it never runs test suites, builds, or formatters that write files. Reviewers may only run checks that write nothing into the repository, such as go vet or gofmt -l, and verify findings by reading code.

Can the review apply the fixes it suggests?▼

No. The report proposes fixes as recommendations only; applying them is a separate, user-approved follow-up task. Neither the parent nor any reviewer sub-agent edits files or mutates git state.

When should I use local review instead of a PR review?▼

Use local review for code as it sits on disk — uncommitted changes, local branches, or codebase audits — where there is no GitHub verdict or submission. Pull request reviews on GitHub are handled by a separate pr-review skill.