claude-inspect-context-size

Context inspection reads your BitBot session environment to display current context percentage and status. Run `/claude-inspect-context-size` or execute `.bitbot/scripts/claude-inspect-context-size/claude-inspect-context-size.sh` to see real-time usage and identify when compaction is needed.

Compaction is recommended when context usage reaches natural break points—typically around 60% capacity. The Skill analyzes your work state and suggests optimal moments to compact, preserving momentum while preventing exhaustion across development, testing, and debugging tasks.

Context compaction consolidates session history into continuation prompts, resetting available tokens while maintaining task continuity. It reduces cognitive load, prevents context exhaustion, and saves time during long development runs by identifying safe break points automatically.

This Skill requires BitBot-enabled sessions and reads session-env data from `.bitbot/session-env/` to function. It's designed specifically for Claude workflows with BitBot integration; standard CLI sessions without this setup cannot access context metrics through this Skill.

After analyzing context percentage and work state, the Skill emits compaction guidance and continuation prompts compatible with the wrapper system. These prompts summarize progress and context, enabling you to resume work seamlessly after compaction without losing task momentum.

The Skill produces a context usage report classifying status by thresholds, identifies natural break points in your work, and recommends actionable strategies to complete current tasks before compaction. It supports proactive planning and reactive checks across documentation, testing, and debugging workflows.