janitor-value

# Skill Value Report Show whether each installed skill is earning the context-window tokens it costs. ## Overview Combine token cost and usage tracking into a single view of every installed skill, sorted with the heaviest unused skills at the top. The report splits each skill's cost into what is permanently loaded (the description) and what only loads on demand (the body), then cross-references recent invocations so the user can see which skills are dead weight. Replaces the v1.2 split between `/janitor-tokens` (cost only) and `/janitor-usage` (usage only). ## Prerequisites - Claude Code with the skills-janitor plugin installed (provides `scripts/value.sh`) - bash 3.2+ (the stock macOS bash works; no external dependencies) - Read access to `~/.claude/skills`, `~/.claude/agents`, and local Claude Code session history - No authentication or API keys required — the script reads local files only ## Instructions ### Step 1: Run the value script ```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 ### Step 2: Present the results Show the table and summary to the user. When explaining results, do NOT describe body tokens as permanent context cost — only descriptions are always loaded. Plugin-namespaced skills appear with their full invocation name (e.g., `marketing-skills:ima...