status · karanb192 — Claude Code skill: what it does, how to install
Displays prompt cache status, cold restart price, and total cache write costs for the active Claude Code session.
MIT ★ 586 updated 2026-10-26
/plugin marketplace add karanb192/claude-code-hooks
/plugin install cache-tax@claude-code-hooksWhat status does
This skill executes cache-tax.js with the --render argument via Node.js. It inspects the active transcript to report conversation cache tiers, whether the cache is warm or lapsed, and overall counts for reads, writes, and full rewrites.
When the cache drops cold on a heavy context, the tool calculates the list price of the upcoming turn. It immediately reports if running /clear with a short handoff note costs less. Node.js must be available on the machine for the underlying script to run.
What it helps with
- inspect prompt cache tiers and session warm status
- calculate cold comeback token prices on large contexts
- decide if resetting context via
/clearsaves money
Example prompts for the agent
- Show the prompt cache status for this session
- Check whether the cache is cold and what the next turn costs
How to install status
1Plugin marketplace
/plugin marketplace add karanb192/claude-code-hooks/plugin install cache-tax@claude-code-hooksThis installs the whole cache-tax plugin with all its skills
2Skills CLI (Vercel)
npx skills add karanb192/claude-code-hooks --skill status -a claude-code3Manually: put the files in place
~/.claude/skills/status/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/status/
1Skills CLI (Vercel)
npx skills add karanb192/claude-code-hooks --skill status -a codex2Manually: put the files in place
.agents/skills/status/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add karanb192/claude-code-hooks --skill status -a cursor2Manually: put the files in place
.cursor/skills/status/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install karanb192/claude-code-hooks plugins/cache-tax/skills/status2Manually: put the files in place
.github/skills/status/SKILL.md1Skills CLI (Vercel)
npx skills add karanb192/claude-code-hooks --skill status -a gemini-cli2Platform CLI
gemini skills install https://github.com/karanb192/claude-code-hooks --path plugins/cache-tax/skills/statusManually: put the files in place
.devin/skills/status/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about status
How to install status in Claude Code?
Run /plugin marketplace add karanb192/claude-code-hooks followed by /plugin install cache-tax@claude-code-hooks.
What does the status skill do?
It renders a card detailing prompt cache tier, warm or lapsed state, token rewrite volume, and next-message expenses.
What dependencies does this skill require?
It invokes cache-tax.js through Node.js, requiring a working Node.js runtime on your path.
Source text
SKILL.md · MIT
---
name: status
description: Show this session's prompt-cache state, the cold-comeback price, and the cache writes paid so far
disable-model-invocation: true
---
# Prompt-cache status
!`node "${CLAUDE_SKILL_DIR}/../../cache-tax.js" --render 2>/dev/null || node "${CLAUDE_PLUGIN_ROOT}/cache-tax.js" --render`
The card above is this session's prompt-cache state from its own transcript: which
cache tier the main conversation is on, whether the cache is warm or has lapsed, how
many tokens the next message re-writes if it is cold and what that costs at list
price, and the session's cache writes, reads and full re-writes so far.
State what the next message will cost in one sentence. If the cache is cold and the
context is large, say whether /clear plus a short handoff note is the cheaper move.
Keep it short; do not re-run any commands.
© Karan Bansal · MIT · karanb192/claude-code-hooks
Similar skills
All skills for Agent setup: memory, context, orchestration →status by other authors comes first.