context-budget
Audits Claude Code context window consumption across agents, skills, MCP servers, and rules. Identifies bloat, redundant components, and produces prioritized token-savings recommendations.
Best for Claude Code users managing…Works with GitHubLow risk
⌘source
- author
@affaan-m- language
- JavaScript
★159kstars
25kforks
Apr 17, 2026
✦overview.md
Key Features
- ·Audits token consumption across agents, skills, MCP servers, and rules
- ·Identifies bloat and redundant components
- ·Produces prioritized token-savings recommendations
- ·Analyzes token overhead across every loaded component
- ·Surfaces actionable optimizations to reclaim context space
Use Cases
- →Session performance feels sluggish or output quality is degrading
- →You've recently added many skills, agents, or MCP servers
- →You want to know how much context headroom you actually have
- →Planning to add more components and need to know if there's room
Best for
- ✓Claude Code users managing many components
- ✓Performance optimization sessions
Not ideal for
- !Users with minimal components loaded
- !One-time analysis without follow-up
FAQs
name
context-budget
description
Audits Claude Code context window consumption across agents, skills, MCP servers, and rules. Identifies bloat, redundant components, and produces prioritized token-savings recommendations.
origin:ECC
Context Budget
Analyze token overhead across every loaded component in a Claude Code session and surface actionable optimizations to reclaim context space.
When to Use
- Session performance feels sluggish or output quality is degrading
- You've recently added many skills, agents, or MCP servers
- You want to know how much context headroom you actually have
- Planning to add more components and need to know if there's room
- Running
/context-budgetcommand (this skill backs it)
How It Works
Phase 1: Inventory
Scan all component directories and estimate token consumption:
Agents (agents/*.md)
- Count lines and tokens per file (words × 1.3)
- Extract
descriptionfrontmatter length - Flag: files >200 lines (heavy), description >30 words (bloated frontmatter)
Skills (skills/*/SKILL.md)
- Count tokens per SKILL.md
- Flag: files >400 lines
- Check for duplicate copies in
.agents/skills/— skip identical copies to avoid double-counting
Rules (rules/**/*.md)
- Count tokens per file
- Flag: files >100 lines
- Detect content overlap between rule files in the same language module
MCP Servers (.mcp.json or active MCP config)
$install
1-click copynpx skills add affaan-m/everything-claude-code --skill context-budgetSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
4/ 5
very goodClear and well structured, with only minor parts that might need a second read.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
3/ 5
mediumPartially actionable with several concrete steps, but still missing important details.