rules-doctor

Validate file references and cross-links in .claude/rules directories.

Updated Aug 23, 2026

Search Tags:#anti-patterns #validation #audit #integrity #references #rules #cross-reference

Ready to run

npx skills add https://github.com/ItsMattG/property-tracker --skill rules-doctor

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: rules-doctor
Source: https://github.com/ItsMattG/property-tracker/tree/main/.claude/skills/rules-doctor
Command: npx skills add https://github.com/ItsMattG/property-tracker --skill rules-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit and maintain the integrity of security and policy rules by scanning the rules directory for broken cross-links, missing patterns, and stale references.

Core Features & Use Cases

Broken Reference Detection: find missing files referenced in rules.
Coverage and Consistency Checks: ensure anti-patterns exist for domains and tech stacks align with documentation.
Cross-Reference Validation: verify settings.json hooks reference existing scripts and documentation.

Quick Start

Run the Rules Doctor scan to produce a health report on the .claude/rules directory and output issues.

Frequently Asked Questions about rules-doctor

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

FAQPage Schema

How do I audit rules health and fix broken references in my configuration directory?▼

To audit rules health and fix broken references, run a validation scan on the rules directory to detect missing files, verify cross-links, and produce a health report of integrity gaps.

What is cross-reference validation for rule documents and settings hooks?▼

Cross-reference validation for rule documents verifies that settings hooks reference existing scripts and documentation, ensuring alignment by checking that referenced rule files actually exist.

How do I detect missing domain files and stale mentions in anti-pattern indices?▼

Detect missing domain files and stale mentions in anti-pattern indices by running coverage and consistency checks that ensure anti-patterns exist for domains and tech stacks align with documentation.

Can I check settings.json hooks to verify they reference existing scripts?▼

Yes, you can check settings.json hooks to verify they reference existing scripts by running a cross-reference validation scan that checks for broken references and missing files in the rules directory.

Why does broken reference detection matter for avoiding prompt or data exfiltration risks?▼

Broken reference detection matters for avoiding exfiltration risks because validating file references and enforcing consistent terminology prevents stale mentions that could expose misaligned security policies or data.