Skillrot
- 2 repo stars
- Updated June 2, 2026
- mishanefedov/skillrot
skillrot is a linter for agent skills that compares embedded CLI usage against installed tool help output so developers can catch stale commands before agents fail.
About
skillrot is a Claude Code marketplace plugin and CLI linter that audits agent skills for external-CLI drift when installed tools change flags or subcommands. Developers run it when skills silently fail mid-task because they still emit outdated docker, gh, codex, or bun commands. Use skillrot <skills-dir> for a report, --fix for confident rewrites, or install via /plugin install skillrot@skillrot.
- Detects removed flags and dead subcommands against live CLI --help
- Supports --fix for high-confidence flag renames in SKILL.md
- --cost mode audits always-on token tax from skill descriptions
- Agent-agnostic CLI runnable in CI with zero runtime dependencies
- Sibling to skill-issue which audits activation instead of CLI drift
Skillrot by the numbers
- Data as of Jul 7, 2026 (Skillselion catalog sync)
/plugin marketplace add mishanefedov/skillrotAdd your badge
Show developers this marketplace is listed on Skillselion. Paste this into your README.
| repo stars | ★ 2 |
|---|---|
| Last updated | June 2, 2026 |
| Repository | mishanefedov/skillrot ↗ |
Why do my agent skills keep running dead CLI flags after tools update without any clear 'skill is out of date' error?
Audit agent skills for external CLI drift by comparing embedded bash commands against installed tool --help output.
Who is it for?
Developers maintaining many SKILL.md wrappers around CLIs who want CI-friendly drift detection and optional auto-fixes.
Skip if: Teams with no custom skills or no shell-out to external CLIs in skill instructions.
What you get
You get a per-skill drift report with file:line references, exit code 1 on errors, and optional in-place fixes for confident flag renames.
Plugins in this marketplace
1 plugin - install individually after you add the marketplace.
Recommended Marketplaces
FAQ
What drift does Skillrot catch in v1?
Removed or renamed long flags, dead subcommands, missing short flags as warnings, and uninstalled CLIs as warnings.
Can Skillrot fix stale skills automatically?
Yes. --fix rewrites only high-confidence flag matches found in the installed CLI's current --help.
How is Skillrot different from skill-issue?
Skillrot checks CLI correctness for the installed version; skill-issue checks whether skills activate at all from their descriptions.