context-audit

Audits CLAUDE.md, rules, and knowledge for progressive disclosure compliance and generates a structured remediation report.

36|1|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/jiahao-shao1/sjh-skills --skill context-audit-jiahao-shao1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: context-audit
Source: https://github.com/jiahao-shao1/sjh-skills/tree/main/skills/context-audit
Command: npx skills add https://github.com/jiahao-shao1/sjh-skills --skill context-audit-jiahao-shao1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit the project's three-layer context management system (CLAUDE.md, rules, knowledge) for progressive disclosure compliance. Checks that all knowledge files are reachable from rules, detects stale references, orphaned files, and CLAUDE.md index leakage. Triggers: 'audit context', 'check context', 'context hygiene', 'context audit', '检查 context', '审计上下文', 'knowledge 覆盖检查'.

Core Features & Use Cases

  • Identify orphaned, deprecated, or mislinked knowledge files and report gaps in rule coverage.
  • Validate end-to-end consistency of CLAUDE.md, rule definitions, and knowledge leaves to support reliable progressive disclosure.
  • Generate a structured compliance report with actionable remediation steps.

Quick Start

Run the audit-context operation to verify coverage, references, and hygiene.

Frequently Asked Questions about context-audit

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

FAQPage Schema
How do I audit CLAUDE.md for unreachable knowledge files and context leakage?

Auditing CLAUDE.md context leakage involves tracing references from rules to knowledge leaves to identify orphaned files. This skill validates the three-layer progressive disclosure system and generates a structured compliance report with actionable remediation steps for stale knowledge.

What is progressive disclosure compliance for project context management?

Progressive disclosure compliance ensures all knowledge files are reachable from rules without orphaned files or index leakage. It validates end-to-end consistency across CLAUDE.md, rule definitions, and knowledge leaves to maintain reliable project context architecture.

How do I check for stale references and orphaned files in my project knowledge base?

Checking for stale references and orphaned files requires tracing rule-to-knowledge links within the context management system. The audit identifies deprecated knowledge, mislinked files, and gaps in rule coverage, then outputs remediation steps to restore hygiene.

Does context auditing work for projects without a three-layer CLAUDE.md structure?

Context auditing is designed specifically for the three-layer architecture of CLAUDE.md, rules, and knowledge. Without this progressive disclosure structure, the compliance checks for index leakage, orphaned files, and reference tracing cannot be properly validated.

What is the best way to validate rule coverage and knowledge file reachability?

Validating rule coverage and knowledge reachability is best done by tracing references from rules to knowledge leaves end-to-end. This detects unreachable knowledge files and CLAUDE.md index leakage, producing a structured compliance report with specific remediation actions.

Why does my context audit report show gaps in rule coverage?

Context audit reports show rule coverage gaps when knowledge files are orphaned, mislinked, or deprecated within the progressive disclosure system. The audit traces references from rules to knowledge leaves and flags these inconsistencies as actionable remediation steps.