jzOcbjzOcbCommunityยท1 Agent Skills Included

context-doctor

Visualize and diagnose context window token usage

Visualizes exactly how your context window budget is spent across workspace files, skills, and system prompts. Detects truncated, missing, or bloated bootstrap files that silently degrade response quality. Outputs colored terminal reports, shareable PNG images, or structured JSON for quick health checks. Helps you trim token waste and keep more room free for actual conversation.
npx skills add jzOcb/context-doctor --all -g -y

All Skills in This Repository (1)

Pure Emerald Level Indicators

Frequently Asked Questions

FAQPage Schema
How to install context-doctor?โ–ผ

Run `npx skills add jzOcb/context-doctor --all -g -y` in your terminal to install it globally.

How to check what is eating my context window tokens?โ–ผ

Run `python3 scripts/context-doctor.py` to see a visual breakdown of workspace files, skills, and system prompt overhead with token estimates for each.

Why did my agent suddenly get dumber?โ–ผ

Bloated or truncated bootstrap files often cause quality drops. Context-doctor flags truncated and missing files so you can fix them quickly.

Can I share the context report as an image?โ–ผ

Yes. Run the script with `--png /tmp/output.png` to generate a shareable image, or use `--json` to pipe structured data into other tools.

Does context-doctor work with custom context sizes?โ–ผ

Yes. Use `--ctx-size N` to match your model's context window and `--workspace PATH` to scan a custom workspace directory.

Related Repositories in Software Engineering

View All in Software Engineeringโ†’