Agent skill

Local Code Review

by gittower in gittower/git-flow-next

Reviews local commits, branch diffs or pull requests against project guidelines and writes the result to local files, never posting it to GitHub.

Custom licenceAuto-check: notesDevelopment

Install Local Code Review

skills CLI
$ npx skills add gittower/git-flow-next --skill code-review -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install gittower/git-flow-next code-review --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/gittower/git-flow-next.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/code-review .claude/skills/code-review && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
code-review
GitHub stars
458
Token cost
~1.9k tokens
SKILL.md length
658 words
Files
2
Skills in repo
25
Repo updated
First seen
Licence
Custom licence

At a glance

Reviews local commits, branch diffs or pull requests against project guidelines and writes the result to local files, never posting it to GitHub.

  • Works in 8 steps: Parse Arguments → Gather Context → Detect and Get Changes → …
  • Reviewing the commits on a feature branch before opening a PR
  • SKILL.md covers Arguments, Instructions and Issue Categories
  • Calls git, gh and go

What it does

The skill reviews whatever target you give it: nothing, which auto-detects new commits on the current branch against main; a commit range or single commit; a branch comparison; or a PR number. An --output option chooses where the review is written, normally a folder inside .ai/. Auto-detect and PR modes save there on their own, while an explicit target without --output prints the review in the conversation.

In auto-detect mode the agent reads the branch name, finds the matching workflow folder in .ai/ and loads the original issue or plan. The main branch comes from the gitflow configuration, with main as the fallback, and the diff is taken against it. PR mode fetches the title, author and branch details with the gh CLI. Review criteria live in REVIEW_CRITERIA.md, and all output stays local.

When your agent uses it

  • Reviewing the commits on a feature branch before opening a PR
  • Reviewing an existing PR by number without posting comments
  • Checking a commit range against the project's guidelines

Example prompts

  • “Review the new commits on this branch and save the review under .ai/.”
  • “Review PR 123 against our guidelines, but don't post anything to GitHub.”
  • “Review HEAD~3..HEAD and print the result here.”

Requirements

  • git
  • The GitHub CLI (gh) for reviewing pull requests
  • Pre-approved tools (allowed-tools): Read, Write, Grep, Glob, Bash

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Parse Arguments
  2. Gather Context
  3. Detect and Get Changes
  4. Review Against Guidelines
  5. Code Quality Checks (auto-detect mode only)
  6. Determine Output Location
  7. Generate Review Report
  8. Report Findings

What it can do on your machine

Read from SKILL.md and the folder at commit 00d1b4b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Grep
    • Glob
    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • gh
    • go

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git and gh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Local Code Review loads about 1.9k tokens when it runs. Until then it costs about 15 tokens; SKILL.md has 658 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~15
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Grep, Glob, Bash

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 658 words (~1,864 tokens).

“Review local changes or pull requests against project guidelines. All output is written locally — never posted to GitHub.”

— opening of SKILL.md by gittower, Custom licence
name
code-review
allowed-tools
Read, Write, Grep, Glob, Bash

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in .claude/skills/code-review of gittower/git-flow-next.

  • SKILL.md
  • REVIEW_CRITERIA.md

Open the folder on GitHubat commit 00d1b4b

Compare with similar skills

Local Code Review next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Local Code Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Local Code Review this skillgittower/git-flow-next458—~1.9kAutomated safety check: NotesCustom licence
PR Review State Fetchprisma/orm48k—~767Automated safety check: PassApache-2.0
Greploop Appsmichaelshimeles/skills1.3k1 repos~3.6kAutomated safety check: PassMIT
PR Triagertk-ai/rtk83k—~2.5kAutomated safety check: NotesApache-2.0
Difit Reviewyoshiko-pg/difit3.2k—~1.2kAutomated safety check: PassMIT
Address PR Feedback for ruby-gitruby-git/ruby-git1.8k—~657Automated safety check: PassMIT

Similar skills

  • Official

    Fetches a pull request's canonical review state as JSON, validates it, and renders markdown, a text summary and triage target files from it using bundled scripts.

    48k GitHub stars~767 tokensUpdated today
    DevelopmentAuto-check passed
  • Greploop Apps

    michaelshimeles/skills

    Loops on a large pull request, merge request or Perforce changelist, fixing Greptile findings until it scores 5/5 with no unresolved comments.

    1.3k GitHub starsUsed in 1 repo~3.6k tokens
    DevelopmentAuto-check passed
  • PR Triage

    rtk-ai/rtk

    Audits a repository's open pull requests, deep-reviews chosen ones and drafts review comments that are only posted after you approve them.

    83k GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check: notes
  • Difit Review

    yoshiko-pg/difit

    Review a specific diff (branch, commit, or GitHub PR) and show the findings as comments inside difit, the local diff viewer.

    3.2k GitHub stars~1.2k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Addresses unresolved pull request review threads and suppressed (low-confidence) Copilot review comments on the current branch, folds each fix into the…

    1.8k GitHub stars~657 tokensUpdated 6 days ago
    DevelopmentAuto-check passed
  • ExecuTorch PR Review

    pytorch/executorch

    Reviews ExecuTorch pull requests or local branches for what CI cannot check, using a checklist, with an optional detailed line-by-line mode.

    5.1k GitHub stars~2.9k tokensUpdated today
    DevelopmentAuto-check passed

More from gittower/git-flow-next

All 25 skills in this repo
  • GitHub Issue Analysis

    gittower/git-flow-next

    Analyzes a GitHub issue for the git-flow-next project and writes an analysis document under .ai/ that covers the affected code and proposes TODO comments.

    458 GitHub starsUsed in 1 repo~694 tokens
    Auto-check: notes
  • PR Review Feedback Handler

    gittower/git-flow-next

    Fetches review comments on a pull request, judges each one, writes the evaluation to a plan file and implements accepted changes, waiting for approval before anything public.

    458 GitHub stars~2.9k tokensUpdated 1 mo ago
    Auto-check: notes
  • Stale PR Review Check

    gittower/git-flow-next

    Scans open pull requests against the project's review response window and reports which ones need action, read-only unless you approve a reminder.

    458 GitHub stars~549 tokensUpdated 1 mo ago
    Auto-check: notes
  • Commit with Project Guidelines

    gittower/git-flow-next

    Creates a commit that follows the project's COMMIT_GUIDELINES.md, choosing the type by what the change does and verifying the result.

    458 GitHub stars~818 tokensUpdated 1 mo ago
    Auto-check: notes
  • Test-First Implementation Plan

    gittower/git-flow-next

    Builds a two-phase implementation plan from a spec issue, analysis or concept, writing a detailed test plan first and the implementation outline second.

    458 GitHub stars~1.3k tokensUpdated 1 mo ago
    Auto-check: notes
  • Create Spec

    gittower/git-flow-next

    Create a Codex-gated spec issue from a triaged report, concept, or idea

    458 GitHub stars~1.4k tokensUpdated 1 mo ago
    Auto-check: notes

Works with

Categories

Questions about Local Code Review

What does Local Code Review do?

Reviews local commits, branch diffs or pull requests against project guidelines and writes the result to local files, never posting it to GitHub. The skill reviews whatever target you give it: nothing, which auto-detects new commits on the current branch against main; a commit range or single commit; a branch comparison; or a PR number.ai/.

When should I use Local Code Review?

Local Code Review fits situations like: reviewing the commits on a feature branch before opening a PR; reviewing an existing PR by number without posting comments; checking a commit range against the project's guidelines.

How do I install Local Code Review in Claude Code?

Run `npx skills add gittower/git-flow-next --skill code-review -a claude-code`. Or copy the skill folder (.claude/skills/code-review in gittower/git-flow-next) into .claude/skills/code-review in your project. Claude Code loads it when a task matches its description.

How do I install Local Code Review in Codex?

Run `npx skills add gittower/git-flow-next --skill code-review -a codex`. Or copy the skill folder (.claude/skills/code-review in gittower/git-flow-next) into .agents/skills/code-review in your project. Codex loads it when a task matches its description.

Can I use Local Code Review in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add gittower/git-flow-next --skill code-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/code-review, .gemini/skills/code-review, .github/skills/code-review and .opencode/skills/code-review in your project.

What does Local Code Review need to run?

Going by SKILL.md and its folder, Local Code Review needs the command-line tools its instructions call (git, gh and go). Our summary lists: git; The GitHub CLI (gh) for reviewing pull requests. Its frontmatter pre-approves these tools: Read, Write, Grep, Glob, Bash.

Does Local Code Review access the network?

SKILL.md contains no URLs. Its commands use git and gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Local Code Review safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Local Code Review use?

Local Code Review has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Local Code Review use?

About 1.9k tokens (SKILL.md is roughly 7.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Local Code Review?

Skills that share tags, products or a category with Local Code Review: PR Review State Fetch (prisma/orm, 48k stars), Greploop Apps (michaelshimeles/skills, 1.3k stars), PR Triage (rtk-ai/rtk, 83k stars) and Difit Review (yoshiko-pg/difit, 3.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Local Code Review?

gittower (a GitHub organization) maintains it in gittower/git-flow-next, which has 458 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on September 8, 2026.

Source: gittower/git-flow-next on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.