diff-skill — Claude Code skill: what it does, how to install
Diffs two revisions of a skill's markdown instructions and flags the edits that weaken a rule or add avoidable complexity. Useful before you accept changes to a skill you rely on.
no license ★ 155 updated 2026-10-29
npx skills add serpro69/claude-toolbox --skill diff-skill -a claude-codeWhat diff-skill does
Point it at a skill and it compares the markdown that drives that skill across two revisions. The check runs one way: a dropped requirement, a softened rule, a missing verification step or a broken link counts as a regression, while fresh clarifications and extra examples do not. Content that moved but survived the edit stays neutral. Complexity is split too: what the edit introduced affects the verdict, and older issues are listed separately as suggestions.
By default it diffs HEAD against the working tree, and you can name other refs in the prompt. Starting from SKILL.md it follows the markdown links and covers every file it can reach, so a rule buried in a reference file still gets compared. Output lands in docs/reviews/diff-skill/<slug>-<sha-a>-<sha-b>.md, plus a short inline summary with the verdict, the finding counts and the path.
The shortcut $kk:diff-skill <skill-name> resolves klaude-plugin/skills/<skill-name>/SKILL.md, and asks you for the directory when that file is missing. Phases are strictly ordered: the skill reads its own diff-process.md first and won't touch the target before that. Findings get indexed in the capy knowledge base under kk:review-findings, but only when there is something to report.
What it helps with
- catch a requirement that vanished during an instruction rewrite
- tell a weakened constraint apart from a harmless clarification
- review every linked file a skill pulls in, not just
SKILL.md - keep older complexity issues from sinking the verdict on a new edit
- get a written report with the path and the number of findings
Example prompts for the agent
- Diff the
deploy-guardskill against its last commit and list anything that got weaker - Run
$kk:diff-skill commit-styleand tell me whether the edit introduced a regression - Compare
HEAD~2with the working tree for therelease-checkskill
How to install diff-skill
1Skills CLI (Vercel)
npx skills add serpro69/claude-toolbox --skill diff-skill -a claude-code2Manually: put the files in place
~/.claude/skills/diff-skill/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/diff-skill/
1Skills CLI (Vercel)
npx skills add serpro69/claude-toolbox --skill diff-skill -a codex2Manually: put the files in place
.agents/skills/diff-skill/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add serpro69/claude-toolbox --skill diff-skill -a cursor2Manually: put the files in place
.cursor/skills/diff-skill/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install serpro69/claude-toolbox kodex-plugin/skills/diff-skill2Manually: put the files in place
.github/skills/diff-skill/SKILL.md1Skills CLI (Vercel)
npx skills add serpro69/claude-toolbox --skill diff-skill -a gemini-cli2Platform CLI
gemini skills install https://github.com/serpro69/claude-toolbox --path kodex-plugin/skills/diff-skillManually: put the files in place
.devin/skills/diff-skill/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about diff-skill
How do I install diff-skill in Claude Code?
Run npx skills add serpro69/claude-toolbox --skill diff-skill -a claude-code. The skill file ends up at ~/.claude/skills/diff-skill/SKILL.md.
What does diff-skill do?
It compares two revisions of a skill's markdown instructions and reports whether degradations or extra complexity came in. Along the way it writes a report under docs/reviews/diff-skill/ and prints a short summary.
Which revisions does it compare by default?
HEAD against the working tree. You can name other refs in the prompt.