token-budget-monitor

Community

Never hit token limits again, stay productive.

Authormapachekurt
Version1.0.0
Installs0

System Documentation

What problem does it solves? Users often hit Claude's conversation token limits unexpectedly during long or tool-heavy sessions, leading to lost context and interrupted workflows. This skill proactively monitors token usage and provides timely warnings, allowing users to save work and plan conversation breaks.

Core Features & Use Cases

  • Proactive Usage Monitoring: Tracks current token usage and conversation pace.
  • Predictive Warnings: Estimates when limits will be reached and issues warnings at critical thresholds (70%, 85%, 95%).
  • Personalized Strategy: Adapts monitoring and warning frequency based on user's historical usage patterns (e.g., heavy tool user, long sessions).
  • Use Case: During a multi-hour skill development session, Claude warns you at 85% token usage, suggesting you commit your work and prepare to start a new conversation to avoid losing context.

Quick Start

This skill operates automatically in the background.

Claude will proactively alert you based on your conversation patterns.

Example of an alert:

Claude (checking tokens): "💡 Token check: We're at ~120k/190k tokens (63%). At our current tool-heavy pace, we have about 1-2 hours left. Let's finish the skill-manager enhancement, commit everything, then start fresh for the YouTube extractor work. Sound good?"

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: token-budget-monitor
Download link: https://github.com/mapachekurt/claude-skills/archive/main.zip#token-budget-monitor

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.