janitor-value
The janitor-value skill analyzes installed skills to determine whether each one justifies its context-window cost by combining token usage data with invocation frequency. Run this when users question skill value, ask about context budget allocation, identify unused skills, or need to optimize their skill collection for token efficiency.
git clone --depth 1 https://github.com/khendzel/skills-janitor /tmp/janitor-value && cp -r /tmp/janitor-value/skills/janitor-value ~/.claude/skills/janitor-valueSKILL.md
# Skill Value Report Show whether each installed skill is earning the context-window tokens it costs. Combines token cost and usage tracking into a single view, sorted with the heaviest unused skills at the top. Replaces the v1.2 split between `/janitor-tokens` (cost only) and `/janitor-usage` (usage only). ## How to Run ```bash bash ~/.claude/skills/skills-janitor/scripts/value.sh [--weeks N] [--budget N] [--json] ``` - `--weeks N` — usage lookback window (default: 4) - `--budget N` — context window size for % calculations (default: 200000) - `--json` — emit raw JSON ## Output A table of every installed skill with: - **Tokens** — approximate token count of the skill's SKILL.md - **Budget** — % of the configured context window - **Used?** — `yes` if invoked in the lookback window, else `NO` - **Last Used** — date of most recent invocation Followed by a summary: - Total tokens loaded into context - Active vs. unused split - Top wasters: heavy skills with zero usage Plugin-namespaced skills appear with their full invocation name (e.g., `marketing-skills:image`, `figma:figma-use`). ## When to Suggest Action If "unused skill cost" exceeds 20% of the budget, recommend the user run `/janitor-report` for a full health check or (in v1.4+) `/janitor-swipe` to triage interactively. ## Related Skills - `/janitor-report` — full health check including duplicates and broken skills - `/janitor-fix --prune` — remove broken symlinks and empty skill dirs - `/janitor-discover` — find new skills or check one before installing
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 which skills you use. Deprecated alias — use /janitor-value (which now combines usage + token cost).