Skill102 repo starsupdated 20d ago

janitor-usage

Show which skills you use. Deprecated alias — use /janitor-value (which now combines usage + token cost).

Install in Claude Code

Copy

git clone --depth 1 https://github.com/khendzel/skills-janitor /tmp/janitor-usage && cp -r /tmp/janitor-usage/skills/janitor-usage ~/.claude/skills/janitor-usage

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.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

More from this repository

janitor-auditSkill

Show all your installed skills. Deprecated alias — use /janitor-report --brief.

janitor-discoverSkill

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.

janitor-fixSkill

Automatically fix skill problems (safe preview first). Also use with --prune to find and remove broken symlinks, empty directories, and orphaned skills.

janitor-precheckSkill

Check if a new skill overlaps with existing ones before installing. Deprecated alias — use /janitor-discover with a URL or path.

janitor-reportSkill

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.

janitor-searchSkill

Search GitHub for new skills to install. Deprecated alias — use /janitor-discover (combines search + pre-install check).

janitor-tokensSkill

Show how many context window tokens each skill consumes. Deprecated alias — use /janitor-value (which combines tokens with usage).

janitor-valueSkill

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.