rules-doctor

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

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/ItsMattG/property-tracker --skill rules-doctor
Or copy as Structured Prompt for Agent
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.