Diff Skill

Compare two versions of a skill's instructions to detect degradations and complexity increases. TRIGGER when: user asks to diff, compare, or review changes to a skill's markdown instructions. Asymmetric check — only regressions count. Additions, clarifications, and strengthenings are not degradations. Compares HEAD → working tree by default. Walks the full reachable file set from SKILL.md via markdown links. Produces a report file under docs/reviews/diff-skill/ and an inline summary.

155 stars 30 forksSkill & Plugin Authoring Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add serpro69/claude-toolbox

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add serpro69/claude-toolbox --skill diff-skill
Manual install
git clone --depth 1 https://github.com/serpro69/claude-toolbox.git /tmp/claude-toolbox
mkdir -p ~/.claude/skills
cp -r /tmp/claude-toolbox/klaude-plugin/skills/diff-skill ~/.claude/skills/diff-skill

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Diff Skill Instructions

**Goal: Detect whether an edit to a skill's markdown instructions introduced degradations or made the skill harder for an LLM to follow.**

Two judgment axes:

1. **Degradation (asymmetric)** — load-bearing instruction dropped, constraint weakened, verification step removed, scope narrowed, required output dropped, or reference broken. Content relocated but preserved is neutral.
2. **Complexity** — split into _regressions_ (introduced or worsened by the edit, affects verdict) and _pre-existing advisories_ (exist regardless of the edit, surfaced as improvement opportunities, does NOT affect verdict).

## Conventions

- **Read capy knowledge base conventions** at [shared-capy-knowledge-protocol.md](shared-capy-knowledge-protocol.md).

## Required Outputs

- [ ] Report written to `docs/reviews/diff-skill/<slug>-<sha-a>-<sha-b>.md`
- [ ] Inline summary presented (under 10 lines: verdict, finding counts, report path)
- [ ] Capy indexed under `kk:review-findings` if any degradation or complexity regression findings exist (skip on clean results and pre-existing advisories)

## Invocation

```
/kk:diff-skill <skill-name>
```

Convenience shortcut: resolves `klaude-plugin/skills/<skill-name>/SKILL.md`. If not found, asks the user for the skill directory path.

Defaults: `HEAD` (before) → working tree (after). User can specify different refs in the prompt.

## Workflow
Read the full skill on GitHub

Details

Skill name
diff-skill
Path
klaude-plugin/skills/diff-skill/SKILL.md
License
Apache-2.0
Repo updated
18 November 2026

FAQ

What does the Diff Skill skill do?

Compare two versions of a skill's instructions to detect degradations and complexity increases. TRIGGER when: user asks to diff, compare, or review changes to a skill's markdown instructions. Asymmetric check — only regressions count. Additions, clarifications, and strengthenings are not degradations. Compares HEAD → working tree by default. Walks the full reachable file set from SKILL.md via markdown links. Produces a report file under docs/reviews/diff-skill/ and an inline summary.

How do I install the Diff Skill skill?

Claude Code plugin: /plugin marketplace add serpro69/claude-toolbox. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Diff Skill popular?

It lives in serpro69/claude-toolbox, which has 155 GitHub stars and 30 forks, and is included in 1 curated skill list.

Related skills

Brainstorm

155

serpro69/claude-toolbox

TRIGGER when: asked to brainstorm, think through, explore, or pressure-test a technical idea or decision through conversation. Interviews adaptively, asks one question at a time, and closes with a chat recap. For technical products, architecture, infrastructure, tools, operations, and engineering workflows. Written design/specification and task-list requests belong to /kk:design; durable domain glossary/reference kits to /kk:model; implementation and fixes to /kk:implement. Not for nontechnical brainstorming.

Productivity & NotesIn 1 list30

Chain of Verification

155

serpro69/claude-toolbox

Apply Chain-of-Verification (CoVe) prompting to improve response accuracy through self-verification. Use when complex questions require fact-checking, technical accuracy, or multi-step reasoning.

AI, LLMs & AgentsIn 1 list30

Clarify Docs

155

serpro69/claude-toolbox

TRIGGER when: asked to clarify or improve existing documentation, PR drafts or issue descriptions, including URLs and pasted bodies. Saves results locally, grounded in requirements and source while preserving meaning. Not for requests to implement, fix or work on an issue, code, config, generic response brevity, or agent instructions. Explicit instruction or SKILL.md targets receive a /kk:implement suggestion without edits or invoking implementation.

Writing & ContentIn 1 list30

Skill Creator

272

curiositech/some_claude_skills

Use this skill when creating a new Claude skill from scratch, editing or improving an existing skill, or measuring skill performance with evals and benchmarks. Invoke whenever the user says things like "make a skill for X", "turn this workflow into a skill", "test my skill", "improve my skill", "run evals", "benchmark this", or "optimize my skill description". Also use proactively when the conversation has produced a repeatable workflow that would benefit from being captured as a skill. Covers the full lifecycle: capture intent → draft SKILL.md → run evals → review with user → iterate → optimi

Skill & Plugin Authoring46

Create Skill

164

alexknowshtml/claude-skills

Turn a session into a high quality Claude skill with research and planning

Skill & Plugin Authoring13

Skill Creator

272

curiositech/some_claude_skills

Guide for creating, improving, benchmarking, and packaging Claude Agent Skills (SKILL.md files). Invoke when users want to create a skill from scratch, improve or test an existing skill, benchmark skill performance with variance analysis, or optimize a skill description for triggering accuracy. Also invoke when users say "turn this into a skill", "make a skill for X", "help me write a SKILL.md", "my skill isn't firing correctly", or want to convert a workflow/conversation into a reusable skill. Invoke proactively when a conversation has produced a repeatable workflow worth capturing. If the us

Skill & Plugin Authoring46

Browse the most popular Claude skills, all skill & plugin authoring skills, or write your own with the skills generator.