Agent skill

Difit

by yoshiko-pg in yoshiko-pg/difit

Ask the user for a code review by opening the changes in difit, a local diff viewer.

MITAuto-check passedDevelopment

Install Difit

skills CLI
$ npx skills add yoshiko-pg/difit --skill difit -a claude-code

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

GitHub CLI
$ gh skill install yoshiko-pg/difit difit --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/yoshiko-pg/difit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/difit .claude/skills/difit && 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
difit
GitHub stars
3.2k
Token cost
~1.3k tokens
SKILL.md length
634 words
Files
2
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

Ask the user for a code review by opening the changes in difit, a local diff viewer.

  • The user names difit
  • SKILL.md covers When to Use This Skill, Overview, Commands and Optional Startup Comments, plus 3 more sections
  • Calls npx
  • Show the diff in the viewer

What it does

Difit is an agent skill from yoshiko-pg/difit. Ask the user for a code review by opening the changes in difit, a local diff viewer. Explicit opt-in only — use when the user names difit, asks to open or show the diff in the viewer, or has a standing instruction to request reviews through difit after changes. Do not use it for ordinary requests to review code, diffs, commits, branches, or pull requests.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Development, covering Code review and Pull requests. The repository describes itself as: A lightweight command-line tool that spins up a local web server to display Git commit diffs in a GitHub-like Files changed view. The licence is MIT.

When your agent uses it

  • The user names difit
  • Show the diff in the viewer
  • Has a standing instruction to request reviews through difit after changes
  • Ordinary requests to review code

Example prompts

  • “/difit”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit 82a765c. 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:

    • npx

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

  • Network

    No URLs in SKILL.md. Its commands use npx, 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

Difit loads about 1.3k tokens when it runs. Until then it costs about 91 tokens; SKILL.md has 634 words of instructions outside code blocks.

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

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.

SKILL.md

The full file from yoshiko-pg/difit at commit 82a765c, republished under its MIT licence (© yoshiko-pg). 634 words, ~1,312 tokens.

Download SKILL.mdSave it as .claude/skills/difit/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
difit
description
Ask the user for a code review by opening the changes in difit, a local diff viewer. Explicit opt-in only — use when the user names difit, asks to open or show the diff in the viewer, or has a standing instruction to request reviews through difit after changes. Do not use it for ordinary requests to review code, diffs, commits, branches, or pull requests.

Difit

When to Use This Skill

difit opens an external browser UI and starts a long-running local server, so launching it must be explicit opt-in:

  • Use this skill only when the user explicitly names difit, asks to open or show the diff in a viewer, or has a standing instruction (for example in project docs or agent configuration) to request reviews through difit after code changes.
  • Do NOT use it for ordinary review requests such as "review these changes", "use the reviewer agent", "find problems in this diff", or "review this PR/commit/branch". Answer those through your normal response channel.
  • When a request is ambiguous, prefer the non-difit path.

Overview

This skill requests a code review from the user using difit. Before running commands, choose <difit-command> using the following rule:

  • If command -v difit succeeds, use difit.
  • Otherwise, use npx difit.
  • If falling back to npx difit would require network access in a sandboxed environment without network permission, request escalated permissions and user approval before running it.

If the user leaves review comments, they are printed to stdout when the chosen difit command exits. When review comments are returned, continue work and address them. If the server is shut down without comments, treat it as "no review comments were provided." Restarting it is unnecessary. Manual verification of whether the page launched correctly is also unnecessary.

Commands

  • Review uncommitted changes before commit: <difit-command> .
  • Review the HEAD commit: <difit-command>
  • Review staging area changes: <difit-command> staged
  • Review unstaged changes only: <difit-command> working

Basic Usage:

bash
<difit-command> <target>                    # View single commit diff. ex: difit 6f4a9b7
<difit-command> <target> [compare-with]     # Compare two commits/branches. ex: difit feature main

Optional Startup Comments

If there is something you want to tell the user when difit opens, attach it as startup comments with --comment. This is useful for review findings, explanations, and any context the user should see directly on the diff.

bash
<difit-command> <target> [compare-with] \
  --comment '{"type":"thread","filePath":"src/foobar.ts","position":{"side":"old","line":102},"body":"line 1\nline 2"}' \
  --comment '{"type":"thread","filePath":"src/example.ts","position":{"side":"new","line":{"start":36,"end":39}},"body":"Range comment for L36-L39"}'
  • Use type: "thread" for each comment.
  • Write comment bodies in the language the user is using.
  • Use position.side: "new" for lines that exist on the target side of the diff.
  • Use position.side: "old" for lines that exist only on the deleted side.
  • Use range comments for issues that span multiple lines.
  • Never copy secrets, tokens, passwords, API keys, private keys, or other credential-like material from the diff into --comment bodies or any command-line arguments.

Including Untracked Files

For uncommitted changes, if files not yet added to git should also appear in the diff, add --include-untracked.

bash
<difit-command> . --include-untracked
Show full SKILL.md (248 more words)Show less

Reusing a Running Server

Keep at most one live difit server per Git root and review target. When you edit again after starting a review, reuse the running server instead of launching another one — repeated launches create duplicate ports and browser tabs.

  • Before starting difit, check whether a difit server you started earlier is still running for the same Git root (for example, the background process you launched is still alive).
  • If one is running for the same target, do not start another and do not reopen its URL. For working-tree targets (., working, staged, and the HEAD default) difit watches the repository, and the open page prompts the user to reload when the diff changes.
  • If review rounds are expected to repeat, start the server with --keep-alive (the server survives browser disconnects) or --background (a detached keep-alive server; prints JSON like {"port":4966,"url":"http://localhost:4966","pid":123} and does not auto-open a browser, so share the URL with the user once).
  • While the server stays alive, exchange feedback without restarting it:
    • <difit-command> comment get --port <port> — read the user's review comments (--format json for structured output).
    • <difit-command> comment add --port <port> '<json>' — add new comments to the running server (same JSON shape as --comment).
    • <difit-command> comment resolve <threadId...> --port <port> — resolve threads you have addressed.
  • If the review target changes (for example, a different commit range), stop the existing server and start a new one rather than leaving two servers for the same repository.

Constraints

Can only be used inside a Git-managed directory.

© yoshiko-pg, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/difit of yoshiko-pg/difit.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 82a765c

Compare with similar skills

Difit 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.

Difit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Difit this skillyoshiko-pg/difit3.2k—~1.3kAutomated safety check: PassMIT
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
WooCommerce Code Reviewwoocommerce/woocommerce11k3 repos~1.1kAutomated safety check: PassCustom licence
Open Code Review CLIalibaba/open-code-review45k—~3.1kAutomated safety check: PassApache-2.0
GitHub Review Iterationprisma/orm48k—~2.2kAutomated safety check: PassApache-2.0
Understand Diff AnalysisEgonex-AI/Understand-Anything86k—~1.4kAutomated safety check: PassMIT

Similar skills

  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • WooCommerce Code Review

    woocommerce/woocommerce

    Reviews WooCommerce code changes against the project's standards, flagging backend PHP architecture, naming, documentation, data integrity and testing violations.

    11k GitHub starsUsed in 3 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Open Code Review CLI

    alibaba/open-code-review

    Runs the ocr command-line tool to review Git changes, a commit or a branch comparison with an AI model, returning line-level comments and optionally applying fixes.

    45k GitHub stars~3.1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Official

    Runs a loop on a GitHub pull request: fetch review state, triage comments into actions, implement them and resolve threads, repeating until nothing actionable is left.

    48k GitHub stars~2.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Understand Diff Analysis

    Egonex-AI/Understand-Anything

    Reads your git changes or a pull request against a prebuilt knowledge graph of the project to explain what changed, which components are affected and what is risky.

    86k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Code Review

    flutter/flutter

    Performs a comprehensive, multi-step code review of pull requests or local code changes, using iterative refinement (generation, critique, synthesis) to ensure high-quality, actionable feedback.

    179k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check passed

More from yoshiko-pg/difit

  • Difit Review

    yoshiko-pg/difit

    A skill for reviewing a specific diff and showing the findings as comments inside difit (the diff viewer).

    3.2k GitHub stars~764 tokensUpdated 1 mo ago
    Auto-check passed
  • 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
    Auto-check passed
  • Difit Dev

    yoshiko-pg/difit

    Ask the user for a code review through difit after code changes in this repository, using pnpm run dev.

    3.2k GitHub stars~708 tokensUpdated 1 mo ago
    Auto-check passed
  • Release

    yoshiko-pg/difit

    Execute the difit release workflow when the user says "リリース" or asks to cut a release.

    3.2k GitHub stars~688 tokensUpdated 1 mo ago
    Auto-check passed
  • Vscode Release

    yoshiko-pg/difit

    Execute the VS Code extension release workflow when the user asks to publish/release the difit VS Code extension.

    3.2k GitHub stars~518 tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Difit

What does Difit do?

Ask the user for a code review by opening the changes in difit, a local diff viewer. Difit is an agent skill from yoshiko-pg/difit. Ask the user for a code review by opening the changes in difit, a local diff viewer.

When should I use Difit?

Difit fits situations like: the user names difit; show the diff in the viewer; has a standing instruction to request reviews through difit after changes; ordinary requests to review code.

How do I install Difit in Claude Code?

Run `npx skills add yoshiko-pg/difit --skill difit -a claude-code`. Or copy the skill folder (skills/difit in yoshiko-pg/difit) into .claude/skills/difit in your project. Claude Code loads it when a task matches its description.

How do I install Difit in Codex?

Run `npx skills add yoshiko-pg/difit --skill difit -a codex`. Or copy the skill folder (skills/difit in yoshiko-pg/difit) into .agents/skills/difit in your project. Codex loads it when a task matches its description.

Can I use Difit 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 yoshiko-pg/difit --skill difit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/difit, .gemini/skills/difit, .github/skills/difit and .opencode/skills/difit in your project.

What does Difit need to run?

Going by SKILL.md and its folder, Difit needs the command-line tools its instructions call (npx). Our summary lists: Node.js.

Does Difit access the network?

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

Is Difit 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 Difit use?

Difit 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 Difit use?

About 1.3k tokens (SKILL.md is roughly 5.2k 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 Difit?

Skills that share tags, products or a category with Difit: PR Babysitter (openinterpreter/openinterpreter, 69k stars), WooCommerce Code Review (woocommerce/woocommerce, 11k stars), Open Code Review CLI (alibaba/open-code-review, 45k stars) and GitHub Review Iteration (prisma/orm, 48k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Difit?

yoshiko-pg (a GitHub user) maintains it in yoshiko-pg/difit, which has 3,239 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on August 28, 2026.

Source: yoshiko-pg/difit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.