Agent skill

Dr Audit Docs Drift

by AHepi in AHepi/DeepReason

Audit dimension - find where documentation deviates from code, using the executable doc checks plus a staleness and unchecked-claims census.

MITAuto-check passed

Install Dr Audit Docs Drift

skills CLI
$ npx skills add AHepi/DeepReason --skill dr-audit-docs-drift -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AHepi/DeepReason dr-audit-docs-drift --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AHepi/DeepReason.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/dr-audit-docs-drift .claude/skills/dr-audit-docs-drift && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
dr-audit-docs-drift
GitHub stars
141
Token cost
~749 tokens
SKILL.md length
360 words
Files
1
Skills in repo
30
Repo updated
First seen
Licence
MIT

At a glance

Audit dimension - find where documentation deviates from code, using the executable doc checks plus a staleness and unchecked-claims census.

  • Works in 6 steps: python tools/docs_verify.py >… → python tools/docs_verify.py --audit >… → python tools/docs_verify.py --links >… → …
  • SKILL.md covers Operations, GATE, Activation plant (first run) and Outlets
  • Calls python, rg and git

What it does

Dr Audit Docs Drift is an agent skill from AHepi/DeepReason. Audit dimension - find where documentation deviates from code, using the executable doc checks plus a staleness and unchecked-claims census. Invoked by dr-audit-orchestrator when docs-drift.md is missing.

Its SKILL.md is about 750 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with Python. The licence is MIT.

Example prompts

  • “/dr-audit-docs-drift”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. python tools/docs_verify.py > proof/docs-full.txt — non-baseline
  2. python tools/docs_verify.py --audit > proof/docs-audit.txt — any
  3. python tools/docs_verify.py --links > proof/docs-links.txt — any
  4. python tools/docs_verify.py --stale > proof/docs-stale.txt —
  5. Unchecked-claims census, docs outside the map (they carry no
  6. Write docs-drift.md: one table, columns as the LEDGER, plus the

What it can do on your machine

Read from SKILL.md and the folder at commit 9607fba. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python
    • rg
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Dr Audit Docs Drift loads about 749 tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 360 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~56
When it runs · the whole SKILL.md, loaded when a task matches
~749

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from AHepi/DeepReason at commit 9607fba, republished under its MIT licence (© AHepi). 360 words, ~749 tokens.

Download SKILL.mdSave it as .claude/skills/dr-audit-docs-drift/SKILL.md (or your agent's skills folder).
name
dr-audit-docs-drift
description
Audit dimension - find where documentation deviates from code, using the executable doc checks plus a staleness and unchecked-claims census. Invoked by dr-audit-orchestrator when docs-drift.md is missing.

Audit: documentation vs code

Entry: LEDGER.md exists, docs-drift.md missing. Exit: docs-drift.md written, LEDGER rows added, proofs in proof/.

The primary instrument already exists: every load-bearing map claim carries an executable check: line. This worker runs the instrument, then censuses what the instrument cannot see.

Operations

  1. python tools/docs_verify.py > proof/docs-full.txt — non-baseline failing check → verdict drifted (doc says X, tree says not-X), one row per check.
  2. python tools/docs_verify.py --audit > proof/docs-audit.txt — any finding → verdict toothless-check (a check that cannot fail guards nothing), one row each.
  3. python tools/docs_verify.py --links > proof/docs-links.txt — any dangling DR- reference → verdict drifted.
  4. python tools/docs_verify.py --stale > proof/docs-stale.txt — table the stale list as verdict stale-stamp rows (advisory: Verified-at behind the code it describes; not proof of drift, proof nobody has looked).
  5. Unchecked-claims census, docs outside the map (they carry no check: lines): for each file in docs/*.md (top level only), rg -c 'check:' <file>. Zero checks AND the file's header/Status line asserts a current-state claim → verify that one claim by grep against the tree; broken → verdict drifted (the RESEARCH_BACKEND header precedent, ledgered as E20). Row only the header/Status claim — deep prose audit is a spec-drift or manual tranche, not this pass.
  6. Write docs-drift.md: one table, columns as the LEDGER, plus the count line. All clean → the table plus all doc instruments at baseline with the five proof files (G2).
Show full SKILL.md (138 more words)Show less

GATE

Pass: five proof files exist; every non-baseline instrument delta has a row; every drifted row's disposition is parked. Verdict labels: drifted | toothless-check | stale-stamp | baseline.

Activation plant (first run)

Change one numeral inside one map document's prose claim (not its check: line), run step 1 scoped (python tools/docs_verify.py <file> if supported, else full), confirm the check catches it OR row the miss as a toothless-check finding against that document; git checkout -- the file, paste the clean status. Either outcome is a valid activation (the plant proves the instrument's edge, red or blind).

Outlets

SituationOutlet
Impulse to fix the doc nowPARK — doc-fix prompt, route dr-change-orchestrator
Check fails because the CODE regressedverdict drifted, note code-side, PARK with route deepreason-orchestrator
Stale stamp on a passing docverdict stale-stamp, disposition baseline — re-stamping without re-running is the one forbidden move

© AHepi, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/dr-audit-docs-drift of AHepi/DeepReason.

Open the folder on GitHubat commit 9607fba

Compare with similar skills

Dr Audit Docs Drift next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Dr Audit Docs Drift compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dr Audit Docs Drift this skillAHepi/DeepReason141—~749Automated safety check: PassMIT
MCP Server Builderanthropics/skills180k64 repos~2.3kAutomated safety check: PassApache-2.0
PDF Processinganthropics/skills180k48 repos~2kAutomated safety check: PassProprietary
NotebookLM Research AssistantPleasePrompto/notebooklm-skill7.8k14 repos~2.4kAutomated safety check: NotesMIT
Manim Video Productionbrowser-use/video-use28k6 repos~3kAutomated safety check: PassMIT
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 64 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • PDF Processing

    anthropics/skills

    Official

    Handles everyday PDF jobs in Python and on the command line: extract text and tables, merge, split, rotate, watermark, fill forms, encrypt and OCR.

    180k GitHub starsUsed in 48 repos~2k tokens
    Documents & OfficeAuto-check passed
  • NotebookLM Research Assistant

    PleasePrompto/notebooklm-skill

    Lets Claude Code ask questions of your Google NotebookLM notebooks through browser automation and return answers grounded in your uploaded sources.

    7.8k GitHub starsUsed in 14 repos~2.4k tokens
    Knowledge ManagementAuto-check: notes
  • Manim Video Production

    browser-use/video-use

    Produces math and technical explainer videos with Manim Community Edition: concept animations, equation derivations, algorithm walkthroughs and data stories.

    28k GitHub starsUsed in 6 repos~3k tokens
    Media & CreativeAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed
  • PPT Master

    hugohe3/ppt-master

    Generates editable PowerPoint decks, rebuilds slides from images, fills .pptx templates and polishes existing presentations through routed workflows.

    58k GitHub starsUsed in 1 repo~2.5k tokens
    Documents & OfficeAuto-check passed

More from AHepi/DeepReason

All 30 skills in this repo
  • Pinker Clarity Workflow

    AHepi/DeepReason

    Orchestrate a Steven Pinker-grounded workflow for teaching, explanatory writing, or material that must do both.

    141 GitHub stars~1.5k tokensUpdated 27 days ago
    Auto-check passed
  • Design, deliver, or audit explanations and lessons with a Pinker-informed focus on phenomena, the curse of knowledge, concrete models, active reasoning, feedback, and revision.

    141 GitHub stars~1.8k tokensUpdated 27 days ago
    Auto-check passed
  • Pinker Write For Readers

    AHepi/DeepReason

    Draft, revise, teach, or audit expository prose using Pinker's cognitive approach to style: classic presentation, reader modeling, curse-of-knowledge repair, coherent information order, deliberate…

    141 GitHub stars~2.1k tokensUpdated 27 days ago
    Auto-check passed
  • Example Battery

    AHepi/DeepReason

    Build a battery of concrete instances BEFORE writing or evaluating any definition, pin, or semantic clause (Reed step 1).

    141 GitHub stars~811 tokensUpdated 27 days ago
    Auto-check passed
  • Authoring Skills

    AHepi/DeepReason

    Rules for writing, editing, and retiring skill and workflow files for LLM agents.

    141 GitHub stars~1.7k tokensUpdated 27 days ago
    Auto-check passed
  • Deepreason Orchestrator

    AHepi/DeepReason

    Entry point for any DeepReason problem. An agent skill from AHepi/DeepReason.

    141 GitHub stars~1.1k tokensUpdated 27 days ago
    Auto-check passed

Works with

Questions about Dr Audit Docs Drift

What does Dr Audit Docs Drift do?

Audit dimension - find where documentation deviates from code, using the executable doc checks plus a staleness and unchecked-claims census. Dr Audit Docs Drift is an agent skill from AHepi/DeepReason. Audit dimension - find where documentation deviates from code, using the executable doc checks plus a staleness and unchecked-claims census.

How do I install Dr Audit Docs Drift in Claude Code?

Run `npx skills add AHepi/DeepReason --skill dr-audit-docs-drift -a claude-code`. Or copy the skill folder (.claude/skills/dr-audit-docs-drift in AHepi/DeepReason) into .claude/skills/dr-audit-docs-drift in your project. Claude Code loads it when a task matches its description.

How do I install Dr Audit Docs Drift in Codex?

Run `npx skills add AHepi/DeepReason --skill dr-audit-docs-drift -a codex`. Or copy the skill folder (.claude/skills/dr-audit-docs-drift in AHepi/DeepReason) into .agents/skills/dr-audit-docs-drift in your project. Codex loads it when a task matches its description.

Can I use Dr Audit Docs Drift in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AHepi/DeepReason --skill dr-audit-docs-drift -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dr-audit-docs-drift, .gemini/skills/dr-audit-docs-drift, .github/skills/dr-audit-docs-drift and .opencode/skills/dr-audit-docs-drift in your project.

What does Dr Audit Docs Drift need to run?

Going by SKILL.md and its folder, Dr Audit Docs Drift needs the command-line tools its instructions call (python, rg and git). Our summary lists: Python 3.

Does Dr Audit Docs Drift access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Dr Audit Docs Drift safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Dr Audit Docs Drift use?

Dr Audit Docs Drift is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dr Audit Docs Drift use?

About 749 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Dr Audit Docs Drift?

Skills that share tags, products or a category with Dr Audit Docs Drift: MCP Server Builder (anthropics/skills, 180k stars), PDF Processing (anthropics/skills, 180k stars), NotebookLM Research Assistant (PleasePrompto/notebooklm-skill, 7.8k stars) and Manim Video Production (browser-use/video-use, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dr Audit Docs Drift?

AHepi (a GitHub user) maintains it in AHepi/DeepReason, which has 141 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on September 10, 2026.

Source: AHepi/DeepReason on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.