🧭 Doc Drift Detector
Catch documentation that drifted from your code. Flags functions and methods named in your docs that are gone from the source, CLI flags documented but missing from the arg parser, env vars the docs mention but the code never reads, example imports of modules that no longer exist, and npm scripts or Make targets your docs reference but the project does not define. Cross-references your README and docs against Python and JS/TS source.
- Identify functions mentioned in READMEs that no longer exist in source code
- Find deprecated environment variables still listed in deployment guides
- Verify that Makefile commands and package.json scripts match documentation
$13
· or 65 creditsSecure checkout via Stripe
Included in download
- Identify functions mentioned in READMEs that no longer exist in source code
- Find deprecated environment variables still listed in deployment guides
- terminal, file_read automation included
- Ready for Cursor
Sample input
Check if my README.md and API.md still match the current codebase. Highlight any stale environment variables or missing functions.
Sample output
Documentation Drift Found
- Rule ID: STALE_ENV_VAR
- Severity: High
- File: README.md:42
- Message: 'API_TIMEOUT_MS' is documented but not found in source or .env.example.
- Evidence:
export API_TIMEOUT_MS=5000 - Remediation: Update docs to 'REQUEST_TTL'.
🧭 Doc Drift Detector
Catch documentation that drifted from your code. Flags functions and methods named in your docs that are gone from the source, CLI flags documented but missing from the arg parser, env vars the docs mention but the code never reads, example imports of modules that no longer exist, and npm scripts or Make targets your docs reference but the project does not define. Cross-references your README and docs against Python and JS/TS source.
$13
· or 65 creditsSecure checkout via Stripe
Included in download
- Identify functions mentioned in READMEs that no longer exist in source code
- Find deprecated environment variables still listed in deployment guides
- terminal, file_read automation included
- Ready for Cursor
- Instant install
Sample input
Check if my README.md and API.md still match the current codebase. Highlight any stale environment variables or missing functions.
Sample output
Documentation Drift Found
- Rule ID: STALE_ENV_VAR
- Severity: High
- File: README.md:42
- Message: 'API_TIMEOUT_MS' is documented but not found in source or .env.example.
- Evidence:
export API_TIMEOUT_MS=5000 - Remediation: Update docs to 'REQUEST_TTL'.
About This Skill
What it does
Doc Drift Detector is a specialized automated auditor designed to ensure your READMEs and Markdown documentation stay in sync with your actual codebase. It scans your project to identify "ghost" references—functions, CLI flags, environment variables, and scripts that are mentioned in your docs but have been deleted or renamed in your source code.
Why use this skill
Manual documentation reviews are error-prone and often skipped during fast-paced development. This skill automates the tedium of cross-referencing string literals in docs against code definitions. Unlike a generic AI prompt, it utilizes a structured scanning workflow that targets specific high-risk areas like package.json, Makefiles, and framework-specific env configurations, providing severity ratings and remediation steps for every discrepancy found.
Supported tools
- Languages: Python, JavaScript, TypeScript
- Config Files: package.json, Makefile, Markdown
- Detection Scopes: Function signatures, CLI flags, Environment variables, Import paths
Use Cases
- Identify functions mentioned in READMEs that no longer exist in source code
- Find deprecated environment variables still listed in deployment guides
- Verify that Makefile commands and package.json scripts match documentation
- Audit CLI flag references in docs against actual argument parser logic
Known Limitations
Heuristic detector. Dynamic or meta definitions can produce false positives, so it flags likely drift for review rather than asserting certainty. It cross-references Python and JS/TS source; other languages are out of scope for the code side.
How to Install
mkdir -p ~/.claude/skills && curl -sL https://www.agensi.io/api/install/doc-drift-detector -o /tmp/doc-drift-detector.zip && unzip -o /tmp/doc-drift-detector.zip -d ~/.claude/skills && rm /tmp/doc-drift-detector.zipFree skills install directly. Paid skills require purchase - use the download button above after buying.
Reviews
No reviews yet - be the first to share your experience.
Only users who have downloaded or purchased this skill can leave a review.
Early access skill
Be the first to review this skill.
Only users who have downloaded or purchased this skill can leave a review.
Security Scanned
Passed automated security review
Permissions
File Scopes
Read-only. It reads both the docs and the source and cross-references them, then prints findings with rule id, severity, file, and line. Ignores node_modules, dist, build, and vendor. Writes nothing and reads no environment variables.
Works with any agent that can read a repo and run a local Python script (Claude Code, Cursor, Codex CLI, and other SKILL.md-compatible agents). Standard library only, no install step. Read-only.