Agent skill

Janitor Value

by khendzel in khendzel/skills-janitor

Show whether each skill is earning its context-window cost — combined tokens-used view sorted by waste.

MITAuto-check passedAgent Workflows

Install Janitor Value

skills CLI
$ npx skills add khendzel/skills-janitor --skill janitor-value -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install khendzel/skills-janitor janitor-value --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/khendzel/skills-janitor.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/janitor-value .claude/skills/janitor-value && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
janitor-value
GitHub stars
123
Used in
1 other repo
Token cost
~1.4k tokens
SKILL.md length
628 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

Show whether each skill is earning its context-window cost — combined tokens-used view sorted by waste.

  • Works in 3 steps: Run the value script → Present the results → Suggest action when waste is high
  • The user asks are my skills worth it
  • SKILL.md covers Overview, Prerequisites, Instructions and Output, plus 3 more sections
  • Calls bash

What it does

Janitor Value is an agent skill from khendzel/skills-janitor. 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 wants to audit skill value, token cost, or usage. Trigger with '/janitor-value'.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Designed for Claude Code. Requires bash 3.2+ (macOS default works). Reads local Claude Code data only (~/.claude/skills, ~/.claude/agents, session history).

It sits in Agent Workflows, covering Context engineering and LLM cost and token optimization. The repository describes itself as: Tinder for your Claude Code skills, subagents and MCP servers. Swipe away what wastes context, scan for prompt injection, get honest token costs. Fixes what it finds and actually… The licence is MIT.

When your agent uses it

  • The user asks are my skills worth it
  • Whats my context budget
  • Which skills are dead weight
  • Wants to audit skill value

Example prompts

  • “are my skills worth it”
  • “s my context budget”
  • “which skills are dead weight”
  • “/janitor-value”

Requirements

  • Compatibility (from SKILL.md): Designed for Claude Code. Requires bash 3.2+ (macOS default works). Reads local Claude Code data only (~/.claude/skills, ~/.claude/agents, session history).
  • Pre-approved tools (allowed-tools): Read, Bash(bash:*)

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Run the value script
  2. Present the results
  3. Suggest action when waste is high

What it can do on your machine

Read from SKILL.md and the folder at commit 4b42f39. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Bash(bash:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • bash

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Designed for Claude Code. Requires bash 3.2+ (macOS default works). Reads local Claude Code data only (~/.claude/skills, ~/.claude/agents, session history).

    From compatibility in the SKILL.md frontmatter.

Context cost

Janitor Value loads about 1.4k tokens when it runs. Until then it costs about 78 tokens; SKILL.md has 628 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~78
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from khendzel/skills-janitor at commit 4b42f39, republished under its MIT licence (© khendzel). 628 words, ~1,357 tokens.

Download SKILL.mdSave it as .claude/skills/janitor-value/SKILL.md (or your agent's skills folder).
name
janitor-value
description
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 wants to audit skill value, token cost, or usage. Trigger with '/janitor-value'.
allowed-tools
Read, Bash(bash:*)
compatibility
Designed for Claude Code. Requires bash 3.2+ (macOS default works). Reads local Claude Code data only (~/.claude/skills, ~/.claude/agents, session history).
argument-hint
[--weeks N] [--budget N] [--json]
version
1.7.0
author
Krzysztof Hendzel <krzysztoff.hendzel@gmail.com>
license
MIT
tags
skills, context-window, token-budget, usage-tracking, maintenance

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:image, figma:figma-use).

Step 3: Suggest action when waste is high

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.

Output

A table of every installed skill with:

  • Always — description tokens, permanently in the system prompt (the real context rent)
  • Body — the rest of SKILL.md, loaded only when the skill triggers (progressive disclosure)
  • 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 (the always-loaded TOTAL includes skills plus subagent descriptions from ~/.claude/agents, reported as % of budget)
  • Active vs. unused split
  • Top wasters: heavy skills with zero usage

Error Handling

  1. Error: value.sh: No such file or directory Solution: The plugin is installed under a different root. Locate it with ls ~/.claude/skills or check the plugin cache, then run the script from its actual location.

  2. Error: Every skill shows NO in the Used? column Solution: The lookback window may be too short or session history is empty. Re-run with a longer window, e.g. --weeks 12.

  3. Error: A skill shows 0 tokens Solution: Its SKILL.md is missing or unreadable. Run /janitor-report to surface broken skills, then /janitor-fix --prune to clean them up.

  4. Error: Percentages look wrong for a non-default model Solution: Pass the correct context size explicitly, e.g. --budget 500000.

Show full SKILL.md (199 more words)Show less

Examples

Example 1: Standard value check

Input: "Are my skills worth their token cost?"

Output: Run bash ~/.claude/skills/skills-janitor/scripts/value.sh, then present the table sorted by waste and the summary line, e.g. "Always-loaded total: 8,420 tokens (4.2% of 200k budget). 6 of 31 skills unused in 4 weeks; top waster: heavy-skill (1,900 tokens, never used)."

Example 2: Longer lookback, custom budget

Input: "Check skill usage over the last quarter against a 500k window."

Output: Run bash ~/.claude/skills/skills-janitor/scripts/value.sh --weeks 12 --budget 500000 and present the same table with the adjusted lookback and percentages.

Example 3: Machine-readable output

Input: "Give me the raw skill value data."

Output: Run the script with --json and return the JSON payload unmodified.

MCP servers (v1.7)

For the MCP side of context cost, run bash {baseDir}/../../scripts/mcp.sh [--weeks N] — inventories every configured server (user, project, plugin) with REAL call counts from session transcripts, and lists servers unused in the window. No token guesses: schemas live server-side, so the janitor reports calls, distinct tools used, and last-used instead.

Resources

  • Report script (plugin-relative): {baseDir}/../../scripts/value.sh
  • /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

© khendzel, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/janitor-value of khendzel/skills-janitor.

Open the folder on GitHubat commit 4b42f39

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in khendzel/skills-janitor, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Janitor Value next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Janitor Value compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Janitor Value this skillkhendzel/skills-janitor1231 repos~1.4kAutomated safety check: PassMIT
Context Mode Output Sandboxmksglu/context-mode26k—~4.1kAutomated safety check: PassCustom licence
Context Mode for Antigravity CLImksglu/context-mode26k—~850Automated safety check: PassCustom licence
Context Fundamentalsguanyang/open-agent-hub9752 repos~4.2kAutomated safety check: PassMIT
Context DoctorjzOcb/context-doctor119—~642Automated safety check: PassMIT
Code Context Slicingtrailofbits/skills7.4k—~2.1kAutomated safety check: PassCC-BY-SA-4.0

Similar skills

  • Context Mode Output Sandbox

    mksglu/context-mode

    Routes large command, file, API and browser output through context-mode tools so only the needed result enters the agent's context, instead of dumping it via Bash.

    26k GitHub stars~4.1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Routing rules for using context-mode MCP tools in Antigravity CLI: sandboxed code runs, file analysis, indexed search and web fetches that keep large output out of the conversation.

    26k GitHub stars~850 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Context Fundamentals

    guanyang/open-agent-hub

    This skill should be used to explain or reason about the foundational concepts of context engineering: what context is, the anatomy of a context window, how attention mechanics work, the U-shaped…

    975 GitHub starsUsed in 2 repos~4.2k tokens
    Agent WorkflowsAuto-check passed
  • Context Doctor

    jzOcb/context-doctor

    Visualize and diagnose OpenClaw context window usage. An agent skill from jzOcb/context-doctor.

    119 GitHub stars~642 tokensUpdated 6 mo ago
    Agent WorkflowsAuto-check passed
  • Code Context Slicing

    trailofbits/skills

    Official

    Picks a small, graph-based slice of source with Trailmark and hands a focused code task to a smaller or local model without exposing the whole repository.

    7.4k GitHub stars~2.1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Token-Saver Configuration

    ppgranger/token-saver

    Checks and tunes token-saver output compression: reads stats, explains why a command was or was not compressed, and edits config files or environment variables.

    153 GitHub stars~1k tokensUpdated 18 days ago
    Agent WorkflowsAuto-check passed

More from khendzel/skills-janitor

  • Janitor Swipe

    khendzel/skills-janitor

    Tinder for your Claude Code skills. An agent skill from khendzel/skills-janitor.

    123 GitHub starsUsed in 2 repos~1.5k tokens
    Auto-check passed
  • Janitor Fix

    khendzel/skills-janitor

    Automatically fix skill problems (safe preview first). An agent skill from khendzel/skills-janitor.

    123 GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Janitor Report

    khendzel/skills-janitor

    Full health check of all your skills in one report. An agent skill from khendzel/skills-janitor.

    123 GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Janitor Discover

    khendzel/skills-janitor

    Find new skills on GitHub or check a specific skill before installing.

    123 GitHub stars~1.6k tokensUpdated 8 days ago
    Auto-check passed

Categories

Questions about Janitor Value

What does Janitor Value do?

Show whether each skill is earning its context-window cost — combined tokens-used view sorted by waste. Janitor Value is an agent skill from khendzel/skills-janitor. Show whether each skill is earning its context-window cost — combined tokens-used view sorted by waste.

When should I use Janitor Value?

Janitor Value fits situations like: the user asks are my skills worth it; whats my context budget; which skills are dead weight; wants to audit skill value.

How do I install Janitor Value in Claude Code?

Run `npx skills add khendzel/skills-janitor --skill janitor-value -a claude-code`. Or copy the skill folder (skills/janitor-value in khendzel/skills-janitor) into .claude/skills/janitor-value in your project. Claude Code loads it when a task matches its description.

How do I install Janitor Value in Codex?

Run `npx skills add khendzel/skills-janitor --skill janitor-value -a codex`. Or copy the skill folder (skills/janitor-value in khendzel/skills-janitor) into .agents/skills/janitor-value in your project. Codex loads it when a task matches its description.

Can I use Janitor Value in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add khendzel/skills-janitor --skill janitor-value -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/janitor-value, .gemini/skills/janitor-value, .github/skills/janitor-value and .opencode/skills/janitor-value in your project.

What does Janitor Value need to run?

Going by SKILL.md and its folder, Janitor Value needs the command-line tools its instructions call (bash). Its frontmatter pre-approves these tools: Read, Bash(bash:*). Compatibility (from SKILL.md): Designed for Claude Code. Requires bash 3.2+ (macOS default works). Reads local Claude Code data only (~/.claude/skills, ~/.claude/agents, session history)..

Does Janitor Value access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Janitor Value safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Janitor Value use?

Janitor Value is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Janitor Value use?

About 1.4k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Janitor Value?

Skills that share tags, products or a category with Janitor Value: Context Mode Output Sandbox (mksglu/context-mode, 26k stars), Context Mode for Antigravity CLI (mksglu/context-mode, 26k stars), Context Fundamentals (guanyang/open-agent-hub, 975 stars) and Context Doctor (jzOcb/context-doctor, 119 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Janitor Value?

khendzel (a GitHub user) maintains it in khendzel/skills-janitor, which has 123 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on September 30, 2026.

Source: khendzel/skills-janitor on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.