Diff reachable Markdown files from SKILL.md between git refs and report degradations.
npx skills add https://github.com/serpro69/claude-toolbox --skill diff-skill
Please help me install this Agent Skill. Skill: diff-skill Source: https://github.com/serpro69/claude-toolbox/tree/main/kodex-plugin/skills/diff-skill Command: npx skills add https://github.com/serpro69/claude-toolbox --skill diff-skill
This Skill enables teams to detect degradations and complexity increases when a skill's Markdown instructions change, by diffing the HEAD version against the working tree and tracing reachable files from SKILL.md.
Run the diff-skill tool to compare a skill's SKILL.md between two git refs and generate an annotated report.
High-intent search queries and answers about installing and using this skill.
To detect instruction degradations in skill Markdown files, diff the HEAD version against the working tree to identify complexity regressions. The tool applies asymmetric judgment where only regressions count, while additions and clarifications remain neutral.
Diffing SKILL.md traces reachable files by following links from the entry point to build the complete comparison surface. It outputs the full contents of all reachable files on both refs and identifies any missing links during the degradation check.
Yes, you can compare skill instructions between different git refs. While the default comparison is asymmetric from HEAD to WORKTREE, the tool supports multi-ref comparisons and allows easy invocation for other refs to generate annotated reports.
The best way to report complexity regressions is to generate a structured report under docs/reviews/diff-skill. This report includes an inline summary for quick review and provides annotated details of all degradations found during the diff.
Asymmetric judgment ensures that additions and clarifications to Markdown instructions are treated as neutral during the diff. Only actual regressions and complexity increases count as degradations, preventing false positives when expanding skill documentation.
Missing links are identified when diffing SKILL.md because the tool traces all reachable files from the entry point to construct the comparison surface. This ensures broken references are reported alongside complexity regressions in the final review.
alexanderopCreate isolated git worktrees for feature branches with safety checks.
mejangoParse SARIF 2.1.0 files to extract and deduplicate findings.
julianobarbosaReview code for quality, bugs, security issues, and best practices using Codex.
theslashdojoIdentify and review exact changes across git states with unified diff output.
