doc-drift-scan

Detect documentation references that no longer match current code paths or commands.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/tuanle96/agent-harness-kit --skill doc-drift-scan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: doc-drift-scan
Source: https://github.com/tuanle96/agent-harness-kit/tree/main/src/templates/.claude/skills/doc-drift-scan
Command: npx skills add https://github.com/tuanle96/agent-harness-kit --skill doc-drift-scan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill detects mismatches between documentation references and the current codebase, preventing outdated info from misleading users.

Core Features & Use Cases

  • Reference Extraction: Gather all code paths, commands, and links referenced in documentation files.
  • Drift Analysis: Validate if these references still exist or have become outdated.
  • Use Case: When preparing a release, automatically verify that all documentation references point to existing code or commands, reducing manual effort and errors.

Quick Start

Use the doc-drift-scan skill to check for outdated references in the project's docs and generate a pull request to update them.

Frequently Asked Questions about doc-drift-scan

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

FAQPage Schema
How do I detect stale documentation references in my codebase?▼

To detect stale documentation references, you analyze project markdown and code files to validate if referenced code paths and commands still exist. This drift analysis identifies mismatches where documentation no longer matches the current codebase, preventing outdated info from misleading users.

How do I check for outdated code paths and commands in markdown files?▼

Checking for outdated code paths in markdown files involves extracting referenced commands and links, then validating their existence using command line tools. This reference validation ensures documentation accuracy by verifying that all references point to existing code or commands during audits.

Can I automate documentation drift scanning during release cycles?▼

Yes, you can automate documentation drift scanning during release cycles. By running automated reference validation across project files, you verify documentation accuracy, reduce manual effort, and generate a pull request to update outdated references automatically.

What tools are needed to validate documentation references against current code?▼

Validating documentation references against current code requires command line tools like grep, test commands, and command -v. These tools operate across markdown and code files to check if referenced paths and commands still exist in the project.

Why does my documentation reference validation fail for existing commands?▼

Documentation reference validation may fail for existing commands if the validation logic uses incorrect syntax or if the code paths have changed. Drift analysis identifies these mismatches, ensuring documentation accuracy and relevance in development workflows.