Install the "review-diff" agent skill from https://github.com/jackfranklin/dotfiles/tree/master/claude/skills/review-diff into .claude/skills/review-diff/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "review-diff", then confirm the skill loads.
Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
skills CLI
$ npx skills add jackfranklin/dotfiles --skill review-diff -a codex
Project install goes to .agents/skills/; add -g for ~/.codex/skills/.
Install the "review-diff" agent skill from https://github.com/jackfranklin/dotfiles/tree/master/claude/skills/review-diff into .agents/skills/review-diff/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "review-diff", then confirm the skill loads.
Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
skills CLI
$ npx skills add jackfranklin/dotfiles --skill review-diff -a cursor
Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.
Install the "review-diff" agent skill from https://github.com/jackfranklin/dotfiles/tree/master/claude/skills/review-diff into .cursor/skills/review-diff/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "review-diff", then confirm the skill loads.
Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
skills CLI
$ npx skills add jackfranklin/dotfiles --skill review-diff -a gemini-cli
Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.
Install the "review-diff" agent skill from https://github.com/jackfranklin/dotfiles/tree/master/claude/skills/review-diff into .gemini/skills/review-diff/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "review-diff", then confirm the skill loads.
Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
skills CLI
$ npx skills add jackfranklin/dotfiles --skill review-diff -a github-copilot
Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.
Install the "review-diff" agent skill from https://github.com/jackfranklin/dotfiles/tree/master/claude/skills/review-diff into .github/skills/review-diff/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "review-diff", then confirm the skill loads.
GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
skills CLI
$ npx skills add jackfranklin/dotfiles --skill review-diff -a opencode
OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
Install the "review-diff" agent skill from https://github.com/jackfranklin/dotfiles/tree/master/claude/skills/review-diff into .opencode/skills/review-diff/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "review-diff", then confirm the skill loads.
OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
Skill name
review-diff
GitHub stars
255
Token cost
~524 tokens
SKILL.md length
285 words
Files
1
Skills in repo
19
Repo updated
First seen
Licence
MIT
At a glance
Present a git diff to the user for inline annotation via the ai-review UI.
Works in 5 steps: Get the diff you want to review. For… → Run the CLI, piping the diff to stdin → Once the CLI launches, check its initial… → …
You want to review code changes before committing
SKILL.md covers Steps and Notes
Calls git and node
What it does
Review Diff is an agent skill from jackfranklin/dotfiles. Present a git diff to the user for inline annotation via the ai-review UI. Use when you want to review code changes before committing or requesting review.
Its SKILL.md is about 520 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development, covering Code review and Git workflow. It works with Git. The repository describes itself as: My dotfiles for my dev environment, compromising of tmux, vim, zsh and git. The licence is MIT.
When your agent uses it
You want to review code changes before committing
Requesting review
Example prompts
“/review-diff”
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
1Get the diff you want to review. For staged changes use git diff --staged;
2Run the CLI, piping the diff to stdin
3Once the CLI launches, check its initial output (e.g. Opening http://localhost:) and tell the user what port the review is active on. Wait…
4Check the exit code and stdout
5The stdout always begins with ## Review: APPROVED or ## Review: CHANGES REQUESTED, followed by any comments as a numbered list. Read each…
What it can do on your machine
Read from SKILL.md and the folder at commit 7ec4998. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
git
node
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use git, 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
Review Diff loads about 524 tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 285 words of instructions outside code blocks.
Always· name and description, kept in context so the agent knows when to use it
~42
When it runs· the whole SKILL.md, loaded when a task matches
~524
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 passed
The automated check found no risky patterns in SKILL.md.
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.
Download SKILL.mdSave it as .claude/skills/review-diff/SKILL.md (or your agent's skills folder).
name
review-diff
description
Present a git diff to the user for inline annotation via the ai-review UI. Use when you want to review code changes before committing or requesting review.
disable-model-invocation
true
You are presenting a git diff for human review using the ai-review CLI.
Steps
Get the diff you want to review. For staged changes use git diff --staged;
for all uncommitted changes use git diff HEAD; for a specific range use
git diff <base>..<head>.
Note: Run git add -N . first to include untracked files in the diff. This records the intent to add the files, making them visible to git diff without fully staging them.
Use --theme light unless the user has expressed a preference for dark mode.
Once the CLI launches, check its initial output (e.g. Opening http://localhost:<port>) and tell the user what port the review is active on. Wait for the CLI to exit. It blocks until the user submits their review.
Check the exit code and stdout:
Exit 0 (Approved): The user approved the diff. Address any inline comments in code, then proceed.
Exit 1 (Changes Requested): The user requested changes. Do not commit or push. Show the user the comments from stdout, address them in code, and offer to run another review pass.
The stdout always begins with ## Review: APPROVED or ## Review: CHANGES REQUESTED, followed by any comments as a numbered list. Read each comment carefully.
Notes
Always pass --title. Derive it from the branch name or the work being done (e.g. "Auth middleware changes", "Dark mode CSS") — never use a generic title like "Diff review".
Always pass --theme. Default to light; switch to dark if the user has indicated a preference.
If the diff is very large (hundreds of files), warn the user before opening and offer to scope it to specific paths: git diff HEAD -- src/.
Review Diff 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.
Audits a module by walking its git history commit by commit, tracking unresolved issues forward, and reporting the ones that survive to HEAD as findings.
Addresses unresolved pull request review threads and suppressed (low-confidence) Copilot review comments on the current branch, folds each fix into the…
Collects every review comment on a pull request, checks each against the real code, fixes the valid ones, pushes, and replies on and resolves each thread.
Present a git diff to the user for inline annotation via the ai-review UI. Review Diff is an agent skill from jackfranklin/dotfiles. Present a git diff to the user for inline annotation via the ai-review UI.
When should I use Review Diff?
Review Diff fits situations like: you want to review code changes before committing; requesting review.
How do I install Review Diff in Claude Code?
Run `npx skills add jackfranklin/dotfiles --skill review-diff -a claude-code`. Or copy the skill folder (claude/skills/review-diff in jackfranklin/dotfiles) into .claude/skills/review-diff in your project. Claude Code loads it when a task matches its description.
How do I install Review Diff in Codex?
Run `npx skills add jackfranklin/dotfiles --skill review-diff -a codex`. Or copy the skill folder (claude/skills/review-diff in jackfranklin/dotfiles) into .agents/skills/review-diff in your project. Codex loads it when a task matches its description.
Can I use Review Diff 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 jackfranklin/dotfiles --skill review-diff -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/review-diff, .gemini/skills/review-diff, .github/skills/review-diff and .opencode/skills/review-diff in your project.
What does Review Diff need to run?
Going by SKILL.md and its folder, Review Diff needs the command-line tools its instructions call (git and node).
Does Review Diff access the network?
SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Review Diff safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Review Diff use?
Review Diff is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Review Diff use?
About 524 tokens (SKILL.md is roughly 2.1k 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 Review Diff?
Skills that share tags, products or a category with Review Diff: Git History Bug Audit (ben-manes/caffeine, 18k stars), Address PR Feedback for ruby-git (ruby-git/ruby-git, 1.8k stars), PR Review Triage (stickerdaniel/linkedin-mcp-server, 3.8k stars) and Beyond Compare Git Diff Opener (SensoriumEmbedded/TeensyROM, 227 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Review Diff?
jackfranklin (a GitHub user) maintains it in jackfranklin/dotfiles, which has 255 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 7, 2026.
Source: jackfranklin/dotfiles on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.
