doctor

Diagnose Claude configuration health issues and generate remediation steps.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Jimmy-Jung/claude_symbiote --skill doctor-jimmy-jung
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doctor
Source: https://github.com/Jimmy-Jung/claude_symbiote/tree/main/.claude/skills/doctor
Command: npx skills add https://github.com/Jimmy-Jung/claude_symbiote --skill doctor-jimmy-jung

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Diagnoses health issues in your .claude setup, including agent files, hook permissions, broken path references, and usage-tracking status, and suggests concrete fixes.

Core Features & Use Cases

  • Validates presence and correctness of .claude project markers (.initialized, VERSION).
  • Checks agent frontmatter (name, description, model) and ensures required files exist; detects misconfigurations across skills, commands, and rules.
  • Produces actionable remediation steps and cross-reference consistency checks to keep Claude configuration healthy.

Quick Start

Install and run the Doctor skill to automatically scan your Claude config and propose fixes.

Frequently Asked Questions about doctor

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

FAQPage Schema
How do I diagnose Claude configuration health issues in my project?

To diagnose Claude configuration health, run a scan that validates project markers, agent frontmatter, and cross-references to identify misconfigurations and generate actionable remediation steps.

What does it mean when Claude agent files have misconfigured frontmatter?

Misconfigured agent frontmatter means required fields like name, description, or model are missing or invalid. A configuration health check verifies these fields and ensures required agent files exist to prevent setup errors.

How do I fix broken path references in my Claude setup?

Fixing broken path references involves running cross-reference consistency checks across project settings, agents, skills, commands, and rules to detect invalid paths and applying the generated actionable remediation steps.

Do I need jq installed to validate Claude usage-tracking wiring?

Yes, you need jq installed to validate Claude usage-tracking wiring and cross-reference consistency. The diagnostic scripts rely on jq to parse configuration files and verify health status.

Can I check if required Claude project markers like VERSION exist?

Yes, you can validate the presence and correctness of Claude project markers like .initialized and VERSION files. The diagnostic scan checks these markers to ensure your project setup is properly initialized.

Why is my Claude configuration not working after adding new skills and commands?

Your Claude configuration may not work due to misconfigurations across skills, commands, or rules, or broken cross-reference consistency. Running a health check identifies these specific issues and provides actionable remediation steps.