context-doctor

Audit CLAUDE.md and AGENTS.md files for context bloat and duplication.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Audit CLAUDE.md/AGENTS.md for context bloat, duplication, and misplaced guidance. Use when agent docs feel too long, redundant, or slow the agent at startup.

Core Features & Use Cases

  • Detect bloated CLAUDE.md files and polyfill best practices for lean context.
  • Identify duplicates across AGENTS.md files and propose a single source of truth with references.
  • Highlight misplaced guidance and suggest moving content to .claude/rules/ with path scoping.
  • Generate a Context Doctor Report with findings and recommended actions.

Quick Start

Run the full audit to generate a Context Doctor Report and review recommendations.

Frequently Asked Questions about context-doctor

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

FAQPage Schema
How do I audit CLAUDE.md files for context bloat and token waste?

Auditing CLAUDE.md for context bloat involves scanning root and workspace files to identify duplication and misplaced guidance, generating a report with actionable improvements to reduce startup delays and wasted tokens.

What is the best way to eliminate AGENTS.md duplication in a monorepo?

To eliminate AGENTS.md duplication in a monorepo, scan workspace files to identify overlapping content and propose a single source of truth with references, ensuring agents load lean context without redundant instructions.

How does misplaced guidance in agent docs affect startup performance?

Misplaced guidance in agent docs slows startup by forcing the agent to process irrelevant context. Moving this content to scoped rules directories like .claude/rules/ restricts instructions to necessary paths, optimizing context loading.

Can I use a documentation audit for both single projects and monorepos?

Yes, a documentation audit can be used for both single projects and monorepos. It evaluates root and workspace files to surface context bloat and duplication, providing recommended actions regardless of project scale.

When should I move agent instructions to .claude/rules/ instead of CLAUDE.md?

You should move agent instructions to .claude/rules/ when guidance is path-specific rather than global. Scoping instructions this way prevents loading unnecessary context during startup, keeping the main documentation lean.

Why does my agent context feel redundant and slow to initialize?

Agent context feels redundant and slow to initialize when CLAUDE.md and AGENTS.md files contain bloat, duplicated instructions, or misplaced guidance, wasting tokens during startup and degrading overall performance.