Agent Skills: Background Usage Check

Check Claude Code plan usage in a throwaway background session — a herdr workspace under herdr, otherwise a hidden detached tmux session. Reports weekly usage percentage, time until reset, and pacing status.

UncategorizedID: idvorkin/chop-conventions/background-usage

Install this agent skill to your local

pnpm dlx add-skill https://github.com/idvorkin/chop-conventions/tree/HEAD/skills/background-usage

Skill Files

Browse the full folder contents for background-usage.

Download Skill

Loading file tree…

skills/background-usage/SKILL.md

Skill Metadata

Name
background-usage
Description
Check Claude Code plan usage in a throwaway background session — a herdr workspace under herdr, otherwise a hidden detached tmux session. Reports weekly usage percentage, time until reset, and pacing status.

Background Usage Check

Check your Claude Code plan usage without blocking your current session.

Always dispatch this to a background Agent subagent. Do NOT run the steps inline.

How to run

Spawn a background Agent that reads and executes _impl.md in this skill's directory:

Agent(
  description: "Check usage",
  prompt: "Read and execute ~/.claude/skills/background-usage/_impl.md — follow all steps and return the one-line summary.",
  run_in_background: true
)

When the agent completes, relay its one-line summary to the user.