# Jzocb Context Doctor Context Doctor

> Context Doctor

- Skill: `tomevault-io/jzocb-context-doctor-context-doctor` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/jzocb-context-doctor-context-doctor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/jzocb-context-doctor-context-doctor/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/jzocb-context-doctor-context-doctor

---


# Context Doctor

Diagnose and visualize how the context window budget is allocated.

## Quick Start

Run the visualization script:

```bash
python3 scripts/context-doctor.py
```

The script auto-detects:
- Workspace path (`~/.openclaw/workspace` or `OPENCLAW_WORKSPACE` env)
- OpenClaw version (via `openclaw --version`)
- Installed skills (system + workspace)
- Bootstrap file sizes and status

## Output Sections

### 1. Workspace Files
Shows each bootstrap file with:
- **Status**: ✓ OK / ✗ MISSING / ⚠ TRUNCATED (symlink target missing = MISSING)
- **Characters & Tokens**: Raw size and estimated token count (chars/4)
- **Visual bar**: Proportional to file size

### 2. Installed Skills
Lists all discovered SKILL.md files from system and workspace skill directories.
Skills are loaded on-demand, not in bootstrap — shown for awareness only.

### 3. Token Budget
Breaks down bootstrap overhead:
- System Prompt (framework)
- Workspace Files (from scan)
- Skills List (metadata descriptions)
- Tool Schemas + Summaries

Shows total bootstrap % vs free conversation space.

## Diagnostic Signals

| Signal | Meaning | Action |
|--------|---------|--------|
| 🔴 TRUNCATED | File exceeded max chars, silently cut | Reduce file size or split content |
| 🟡 MISSING | File not found or broken symlink | Check path, fix symlink target |
| 🟢 Bootstrap <10% | Healthy | No action needed |
| 🟠 Bootstrap >15% | Heavy | Review workspace files for bloat |

## Image Output (for chat / sharing)

Generate a PNG image directly — no terminal screenshot needed:

```bash
python3 scripts/context-doctor.py --png /tmp/context-doctor.png
```

The script renders a colored terminal-style image via Rich SVG export.
Requires: `rich` (pip3 install rich) + one of: `rsvg-convert` (brew install librsvg) or `cairosvg` (pip3 install cairosvg).

**Agent workflow**: When a user asks about context health in chat, run with `--png` and send the image directly. The output path is printed to stdout on success.

---
> Source: [jzOcb/context-doctor](https://github.com/jzOcb/context-doctor) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-17 -->