reference-audit

Scan codebases for infrastructure artifacts and validate docs/references coverage.

Updated Mar 1, 2026
One-click install
npx skills add https://github.com/gerardloupecyb/claude-code-project-template --skill reference-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reference-audit
Source: https://github.com/gerardloupecyb/claude-code-project-template/tree/main/.claude/skills/reference-audit
Command: npx skills add https://github.com/gerardloupecyb/claude-code-project-template --skill reference-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps project documentation aligned by scanning the codebase for infrastructure artifacts, detecting gaps and stale entries in docs/references, and cross-referencing MCP mappings.

Core Features & Use Cases

  • Cross-reference MCP entries between services-and-access.md and tool-routing.md.
  • Detect and flag stale reference items based on Last verified dates.
  • Auto-populate missing sections in docs/references with discovered artifacts.

Quick Start

Run the /reference-audit command to initiate a full audit that detects artifacts, cross-references MCP entries, and flags stale references.

Frequently Asked Questions about reference-audit

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

FAQPage Schema
How do I keep documentation synced with infrastructure artifacts in a multi-service project?

To keep documentation synced with infrastructure artifacts, an automated reference audit scans the codebase to detect gaps, validate MCP mappings, and flag stale Docker references across multi-service projects.

What is the best way to detect stale documentation references in my codebase?

Detecting stale documentation references is handled by scanning docs and flagging entries based on their Last verified dates, ensuring your project's knowledge base stays accurate and synchronized with the actual codebase.

How do I cross-reference MCP entries between services-and-access and tool-routing files?

Cross-referencing MCP entries between services-and-access.md and tool-routing.md is automated by running a full reference audit command, which validates the mappings and identifies inconsistencies across your multi-service architecture.

Can I automatically populate missing sections in my docs/references directory?

Yes, you can automatically populate missing sections in docs/references with discovered artifacts by using optional flags during the reference audit, which auto-populates the discovered infrastructure mappings into the documentation.

Does the reference audit support scanning Docker references and secret tables?

Yes, the reference audit supports scanning Docker references and secret tables. It validates these infrastructure artifacts to ensure they stay synchronized across multi-service projects during the automated documentation audit.