janitor-usage
The janitor-usage skill is a deprecated alias that has been replaced by /janitor-value, which provides a combined view of both usage metrics and token costs sorted by waste. When invoked, it runs the value.sh script to display which skills are being used, with historical usage data still accessible through the raw JSON file at ~/.claude/skills/skills-janitor/data/usage-history.json.
git clone --depth 1 https://github.com/khendzel/skills-janitor /tmp/janitor-usage && cp -r /tmp/janitor-usage/skills/janitor-usage ~/.claude/skills/janitor-usageSKILL.md
# Usage Tracking (Deprecated Alias) **Renamed in v1.3.** Usage and token-cost are now merged into one view: `/janitor-value`. The combined report sorts skills by waste (heavy + unused first), which is more useful than seeing usage alone. This alias will be removed in v1.4. When invoked, run `/janitor-value` and mention the rename in one short line at the top. ## How to Run ```bash bash ~/.claude/skills/skills-janitor/scripts/value.sh [--weeks N] [--json] ``` ## Migration - Just usage data → still available via `value.sh` (usage is shown in the combined table) - Raw JSON usage history → `~/.claude/skills/skills-janitor/data/usage-history.json` (unchanged) ## Related Skills - `/janitor-value` — the new combined view - `/janitor-report` — full health check
Show all your installed skills. Deprecated alias — use /janitor-report --brief.
Find new skills on GitHub or check a specific skill before installing. Use when the user wants to search for skills, evaluate a skill URL, check overlap with existing skills before installing, or compare a local skill against alternatives.
Automatically fix skill problems (safe preview first). Also use with --prune to find and remove broken symlinks, empty directories, and orphaned skills.
Check if a new skill overlaps with existing ones before installing. Deprecated alias — use /janitor-discover with a URL or path.
Full health check of all your skills in one report. Use when the user wants to check for errors, find duplicates, detect broken skills, or get a complete overview of skill health. Pass --brief for inventory only.
Search GitHub for new skills to install. Deprecated alias — use /janitor-discover (combines search + pre-install check).
Show how many context window tokens each skill consumes. Deprecated alias — use /janitor-value (which combines tokens with usage).
Show whether each skill is earning its context-window cost — combined tokens-used view sorted by waste. Use when the user asks 'are my skills worth it', 'what's my context budget', 'which skills are dead weight', or anything about skill value, token cost, or usage.