diff-skill Skill
Vergleicht zwei Versionen von Skill-Instruktionen, um Verschlechterungen der Anweisungen und Komplexitäts-Regressionen zu erkennen.
- GitHub Stars
- 155
- Dateien
- 14
- Letzter Commit
- 10. Nov. 2026
- Lizenz
- —
- Erlaubte Tools
- —
Was macht der diff-skill Skill?
diff-skill ist ein Agent Skill. Vergleicht zwei Versionen von Skill-Instruktionen, um Verschlechterungen der Anweisungen und Komplexitäts-Regressionen zu erkennen.
Zusammenfassung erzeugt aus der SKILL.md des Skills.
Über den diff-skill skill
Entwickler, die Änderungen an Skill-Instruktionen überprüfen, können dieses Tool nutzen, um Verschlechterungen der Anweisungen oder Komplexitäts-Regressionen zu identifizieren. Es fungiert als asymmetrischer Check, was bedeutet, dass vorteilhafte Ergänzungen oder Klarstellungen ignoriert werden und der Fokus rein auf negativen Änderungen liegt, wie etwa weggefallenen Constraints, abgeschwächten Verifizierungsschritten oder kaputten Referenzen. Ein Agent sollte diesen Skill laden, wenn ein User verlangt, Änderungen an den Markdown-Instruktionen eines Skills zu diffen, zu vergleichen oder zu reviewen.
Das Tool vergleicht standardmäßig die HEAD-Version mit dem Working Tree und durchläuft dabei den gesamten erreichbaren Dateisatz über Markdown-Links, ausgehend von der SKILL.md. Es erstellt eine detaillierte Berichtdatei unter docs/reviews/diff-skill/ und liefert eine Inline-Zusammenfassung mit dem Urteil und der Anzahl der Funde. Wenn das Tool Verschlechterungen oder Komplexitäts-Regressionen erkennt, werden diese unter kk:review-findings indiziert. Die sequentielle Ausführung wird durch die Datei diff-process.md gesteuert.
Was ein agent damit machen kann
- 1Instruktions-Verschlechterung erkennenPrüfen, ob eine Bearbeitung der Markdown-Instruktionen eines Skills versehentlich eine wesentliche Anweisung entfernt oder einen Constraint abgeschwächt hat.
- 2Komplexitäts-Regressionen identifizierenFeststellen, ob kürzliche Änderungen dazu geführt haben, dass ein Skill für ein Large Language Model schwerer zu befolgen ist.
- 3Automatisierte Review-Berichte erstellenEinen Markdown-Bericht erstellen, der die Unterschiede zwischen zwei Versionen der Dokumentation eines Skills dokumentiert.
- 4Änderungen der Skill-Instruktionen auditierenDie Unterschiede zwischen dem aktuellen HEAD und dem Working Tree für einen spezifischen Skill überprüfen.
Geschrieben basierend auf dem SKILL.md des skills. Jeder use case wurde gegen ein zitat daraus geprüft.
So installierst du den diff-skill Skill
Jeder Befehl kopiert den Skill-Ordner in das Skills-Verzeichnis des Clients. Starte den Client neu oder beginne eine neue Session, um ihn zu laden.Den diff-skill Skill in Plugin installieren
/plugin marketplace add serpro69/claude-toolbox /plugin install kk@claude-toolbox
Den diff-skill Skill in Claude Code installieren
~/.claude/skills/diff-skill/SKILL.md
$ npx degit serpro69/claude-toolbox/klaude-plugin/skills/diff-skill ~/.claude/skills/diff-skillDen diff-skill Skill in Claude Code (project) installieren
.claude/skills/diff-skill/SKILL.md
$ npx degit serpro69/claude-toolbox/klaude-plugin/skills/diff-skill .claude/skills/diff-skillDen diff-skill Skill in Codex installieren
~/.agents/skills/diff-skill/SKILL.md
$ npx degit serpro69/claude-toolbox/klaude-plugin/skills/diff-skill ~/.agents/skills/diff-skillDen diff-skill Skill in Gemini CLI installieren
~/.gemini/skills/diff-skill/SKILL.md
$ npx degit serpro69/claude-toolbox/klaude-plugin/skills/diff-skill ~/.gemini/skills/diff-skillDen diff-skill Skill in Claude.ai installieren
npx degit serpro69/claude-toolbox/klaude-plugin/skills/diff-skill diff-skill && zip -r diff-skill.zip diff-skill # claude.ai → Customize → Skills → + → Create skill → Upload a skill → diff-skill.zip
SKILL.md
Auf GitHub ansehenDiff 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:
- 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.
- 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.
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-findingsif 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
Mandatory order — load instructions before acting on subject matter. The phases below are strictly sequential. Do not read skill content, build file sets, or produce judgments until you have loaded and internalized the full process file. The only early contact with the target skill is its name and SKILL.md path — enough to validate, not enough to judge.
See diff-process.md for the detailed step-by-step process.
Dateien in diesem Skill
14diff-skill Skill-Fragen
Wie installiere ich den diff-skill Skill in Claude Code?
Führe npx degit serpro69/claude-toolbox/klaude-plugin/skills/diff-skill ~/.claude/skills/diff-skill aus. Claude Code lädt Skills aus ~/.claude/skills (alle Projekte) oder .claude/skills (ein Projekt) und nutzt einen Skill, wenn seine Beschreibung zur Aufgabe passt.
Welche Clients können den diff-skill Skill nutzen?
Jeder Client, der das Agent Skills-Format liest: Claude Code, Codex, Gemini CLI und claude.ai (als ZIP hochladen). Skripte im Skill laufen nur dort, wo der Client Codeausführung erlaubt.
Was gilt für den Skill als Verschlechterung?
Eine Verschlechterung ist definiert als eine weggefallene, wesentliche Anweisung, eine abgeschwächte Einschränkung, ein entfernter Verifizierungsschritt, ein verengter Scope, ein fehlender erforderlicher Output oder ein kaputter Referenzpfad.
Wie werden Ergänzungen und Klarstellungen beim Vergleich behandelt?
Ergänzungen, Klarstellungen und Verstärkungen werden nicht als Verschlechterungen gewertet.
Wo wird der Vergleichsbericht gespeichert?
Der Bericht wird im Verzeichnis docs/reviews/diff-skill/ gespeichert.