tl-docs-audit

Audit code and documentation gaps with a structured two-pass workflow.

Updated Feb 14, 2026
One-click install
npx skills add https://github.com/toddlevy/tl-agent-skills --skill tl-docs-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tl-docs-audit
Source: https://github.com/toddlevy/tl-agent-skills/tree/main/skills/tl-docs-audit
Command: npx skills add https://github.com/toddlevy/tl-agent-skills --skill tl-docs-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Documentation often drifts from code, creating gaps, stale information, and misalignment between implementation and documentation. This skill identifies these issues and prepares a plan to synchronize docs with code.

Core Features & Use Cases

  • Inventory the codebase's documentable elements (API docs, configuration docs, READMEs, guides).
  • Perform a two-pass audit (doc-first and code-first), categorize findings (missing, outdated, structural, orphaned, incomplete), and generate a structured sync report with evidence.
  • Optionally apply proposed fixes with user approval to improve documentation quality and coverage.

Quick Start

Run a full documentation audit on the current project to generate a sync report.

Frequently Asked Questions about tl-docs-audit

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

FAQPage Schema
How do I audit documentation for gaps and staleness?

Run a two-pass documentation audit to identify missing, outdated, and structural issues. It inventories documentable elements and generates a structured sync report with evidence of documentation gaps.

What is the best way to sync docs with code after recent changes?

Scope a documentation audit to changed files to detect sync issues. It performs feature inventory and staleness checks, then optionally applies proposed fixes with approval to update outdated documentation.

How does a doc-first and code-first audit pass work?

A doc-first pass checks existing documentation coverage, while a code-first pass identifies undocumented features. Categorizes findings into missing, outdated, orphaned, or incomplete documentation to generate a sync report.

Can I automatically fix outdated documentation identified during an audit?

Yes, the audit can optionally apply proposed fixes with user approval. After identifying staleness and gaps, it guides fixes to improve documentation quality and coverage automatically.

Does the documentation audit work for specific project areas or only full codebases?

It applies to full codebase audits, changed-files scopes, or specific areas. You can target a full sync report or guide fixes for a particular section without auditing the entire project.

Why does my documentation drift from code implementation?

Documentation drifts from code due to missing updates after implementation changes. A gap-analysis audit identifies outdated and orphaned docs, categorizing findings to prepare a synchronization plan.