context-budget

Analyze token overhead across Claude Code session components and prioritize savings.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/cescrafli/compyrasion --skill context-budget-cescrafli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: context-budget
Source: https://github.com/cescrafli/compyrasion/tree/main/skills/context-budget
Command: npx skills add https://github.com/cescrafli/compyrasion --skill context-budget-cescrafli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill audits token usage across all loaded components in a Claude Code session to identify context overhead and opportunities to reclaim headroom.

Core Features & Use Cases

  • Context Inventory: scans agents (.md), skills//SKILL.md, rules/**/*.md, and MCP configurations to estimate token use and flag bloated frontmatter, heavy files, and oversized MCP servers.
  • Prioritized Optimizations: produces a ranked list of token-savings opportunities with actionable recommendations.
  • Impactful Planning: helps teams plan capacity when adding new agents or skills by projecting context overhead.

Quick Start

Run /context-budget to generate a full context-budget report.

Frequently Asked Questions about context-budget

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit token usage and reduce context overhead in Claude Code?

You can reclaim context headroom by running a context-budget audit, which scans loaded agents, skills, rules, and MCP servers to quantify token overhead and produce a prioritized list of savings opportunities.

What is the best way to optimize context space when adding new agents and skills?

The best way to optimize context space is to project context overhead before adding new components, using a context inventory to flag heavy files and bloated frontmatter, ensuring you maintain safe defaults and sufficient headroom.

How does a context budget report identify token savings opportunities?

A context budget report identifies token savings by analyzing agents/*.md, skills/*/SKILL.md, rules/**/*.md, and MCP configurations to estimate token use, flagging bloated frontmatter, heavy files, and oversized MCP servers for actionable optimization.

Can I analyze MCP configurations to estimate token use without breaking my session?

Yes, you can analyze MCP configurations to estimate token use safely. The audit process scans these configurations to flag oversized MCP servers while maintaining safe defaults, preventing context overflow without disrupting the active session.

Why does my Claude Code session run out of context headroom so quickly?

Your Claude Code session runs out of context headroom due to token overhead from bloated frontmatter, heavy files, and oversized MCP servers. A context budget audit quantifies this overhead across all loaded components to pinpoint the exact cause.