Skill102 estrellas del repoactualizado 21d ago

janitor-value

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.

Ver fuente Repositorio: skills-janitor

Instalar en Claude Code

Copiar

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

Después abre una sesión nueva de Claude Code; el skill carga automáticamente.

Definición

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

Del mismo repositorio

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-usageSkill

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