context-doctor

Diagnose OpenClaw context window token usage across bootstrap files and installed skills.

117|4|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/jzOcb/context-doctor --skill context-doctor-jzocb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: context-doctor
Source: https://github.com/jzOcb/context-doctor/tree/main
Command: npx skills add https://github.com/jzOcb/context-doctor --skill context-doctor-jzocb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires rich, cairosvg, and includes scripts (resource) components.

What problem does it solve?

This tool visualizes how the OpenClaw context window is allocated across bootstrap files and installed skills, helping users understand token usage and diagnose context-related bottlenecks.

Core Features & Use Cases

  • Visualization of workspace files (status, chars, tokens) and installed skills inventory.
  • Token budget breakdown and health signals to guide trimming and debugging.
  • Use Case: audit bootstrap overhead after editing workspace files to verify impact on context efficiency.

Quick Start

Run the visualization script to see a breakdown of workspace files, installed skills, and token budget.

Frequently Asked Questions about context-doctor

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

FAQPage Schema
How do I visualize OpenClaw context window token usage?

To visualize OpenClaw context window token usage, run the script to scan bootstrap files and installed skills, generating a visual breakdown of token allocation and health signals. It computes a token budget to show exactly how workspace files consume available context.

What is the best way to audit bootstrap overhead after editing workspace files?

The best way to audit bootstrap overhead after editing workspace files is to run a diagnostic scan that enumerates installed skills and computes a token budget breakdown. This verifies the impact of your edits on context efficiency and detects missing items or truncations.

Why does my agent performance drop when loading multiple workspace skills?

Agent performance may drop because workspace skills consume context window tokens, reducing available space for processing. Diagnose this by scanning bootstrap files to visualize token allocation and identify context-related bottlenecks that limit agent capacity.

Can I detect truncations or missing items in OpenClaw bootstrap files?

Yes, you can detect truncations or missing items in OpenClaw bootstrap files by running the context visualization script. It scans workspace files, checks their status, and reports any detected truncations or missing items alongside the token budget breakdown.

Do I need rich or cairosvg to generate context window diagnostics?

Yes, you need rich and cairosvg installed as dependencies to generate context window diagnostics. These libraries enable the script to render visual token budget breakdowns and workspace file status reports for your OpenClaw environment.