YuzuruS/claude-skill-cleaner

5 stars · Last commit 2026-05-26

Read-only audit CLI for Claude Code skills & subagents — token cost, duplicates, outdated plugin versions, unused skills. Port of steipete/agent-scripts skill-cleaner to Claude Code.

README preview

# claude-skill-cleaner

Read-only audit CLI for **Claude Code** skills and subagents. It shows what is eating your
skill prompt budget, what is duplicated or outdated, and what you have never actually
invoked — so you can trim with confidence. It **only suggests; it never deletes.**

A Claude Code port of [steipete/agent-scripts](https://github.com/steipete/agent-scripts)'
`skill-cleaner`, which targets Codex/OpenClaw.

## Why

Plugins and skills pile up. On a real machine this tool found **197 `SKILL.md` files on
disk but only 98 actually loaded** — the rest were marketplace catalog copies, old cached
plugin versions, and `upstream/` duplicates. Subagents in `~/.claude/agents` cost *more*
tokens (≈9k) than the loaded skills themselves (≈6k).

## Install

No dependencies. Requires Node 22.6+ (for `--experimental-strip-types`).

View full repository on GitHub →