doctor

Validate .claude/ configuration for errors, security issues, and best practices.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill identifies and reports potential issues in your .claude/ configuration, ensuring that commands work correctly, paths exist, hooks are valid, and agents are well-formed.

Core Features & Use Cases

  • Configuration Validation: Checks the integrity of your .claude/ setup, including CLAUDE.md, agents, skills, rules, and hooks.
  • Error Reporting: Provides detailed reports on any configuration issues, with specific descriptions and potential fixes.
  • Security Checks: Ensures that your configuration is secure, with no malicious code or data exfiltration risks.

Quick Start

Run the doctor skill to validate your .claude/ configuration.

Frequently Asked Questions about doctor

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

FAQPage Schema
How do I validate my .claude/ configuration for errors?

You can validate your .claude/ configuration by running a diagnostic check that inspects CLAUDE.md, agents, skills, rules, and hooks for missing files, incorrect syntax, and structural integrity issues.

What does a .claude/ security check look for?

A .claude/ security check scans your configuration for potential security threats, ensuring there is no malicious code or data exfiltration risks present in your files and hooks.

How do I fix incorrect syntax in .claude/ hooks and agents?

To fix incorrect syntax in .claude/ hooks and agents, run a configuration validation tool that provides detailed error reports with specific descriptions and potential fixes for each issue.

Can I check .claude/ configuration integrity without external dependencies?

Yes, you can check .claude/ configuration integrity without external dependencies using a standalone CLI tool that requires only access to the .claude/ directory and relevant permissions.

Why are my .claude/ commands not working correctly?

Your .claude/ commands might not be working due to configuration errors such as missing files, incorrect syntax, invalid hooks, or poorly formed agents that fail configuration validation.