Agent skill

Dr Audit Dead

by AHepi in AHepi/DeepReason

Audit dimension - find code that is no longer used, via a reference census over every top-level symbol, one package per invocation.

MITAuto-check passed

Install Dr Audit Dead

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

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

GitHub CLI
$ gh skill install AHepi/DeepReason dr-audit-dead --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-dead .claude/skills/dr-audit-dead && 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-dead
GitHub stars
141
Token cost
~777 tokens
SKILL.md length
408 words
Files
1
Skills in repo
30
Repo updated
First seen
Licence
MIT

At a glance

Audit dimension - find code that is no longer used, via a reference census over every top-level symbol, one package per invocation.

  • Works in 2 steps: Symbol census → For each symbol NAME, count referencing…
  • SKILL.md covers Operations (for the next…, GATE, Activation plant (first run) and Outlets
  • Calls rg

What it does

Dr Audit Dead is an agent skill from AHepi/DeepReason. Audit dimension - find code that is no longer used, via a reference census over every top-level symbol, one package per invocation. Invoked by dr-audit-orchestrator when dead.md is missing or has pending package rows.

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

The licence is MIT.

Example prompts

  • “/dr-audit-dead”

Workflow steps

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

  1. Symbol census
  2. For each symbol NAME, count referencing files outside its defining

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:

    • rg

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

  • Network

    No URLs in SKILL.md.

    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 Dead loads about 777 tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 408 words of instructions outside code blocks.

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

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). 408 words, ~777 tokens.

Download SKILL.mdSave it as .claude/skills/dr-audit-dead/SKILL.md (or your agent's skills folder).
name
dr-audit-dead
description
Audit dimension - find code that is no longer used, via a reference census over every top-level symbol, one package per invocation. Invoked by dr-audit-orchestrator when dead.md is missing or has pending package rows.

Audit: dead code

Entry: LEDGER.md exists; dead.md missing or contains a package row marked pending. Exit for one invocation: ONE package's census complete, its row flipped to done. The router re-invokes until no pending rows remain (S1: the loop lives in the router).

On first invocation, write the package list into dead.md: ls -d src/deepreason/*/ src/deepreason/*.py, one row each, all pending.

Operations (for the next pending package P)

  1. Symbol census: rg -n '^(def|class) [A-Za-z_]' <P> --type py > proof/dead-<P>-symbols.txt
  2. For each symbol NAME, count referencing files outside its defining file: rg -l -w 'NAME' src/ tests/ scripts/ tools/ | grep -v <defining-file> Hits ≥ 1 → verdict referenced (no LEDGER row; tally only). Hits = 0 → step 2b. 2b. Intra-file use check (a symbol called only from its own file is wired, not dead): rg -c -w 'NAME' <defining-file> Count ≥ 2 (the definition line plus at least one use) → verdict referenced, note intra-file (tally only). Count = 1 → step 3.
  3. String-reference scan (dynamic dispatch, registries, config strings): rg -l "['\"]NAME['\"]" src/ tests/ scripts/ tools/ Hits ≥ 1 → verdict dynamic-ref, row it with the hit file (these are load-bearing but invisible to imports — worth a row, not a prompt). Hits = 0 → step 4.
  4. Entry-point scan: rg -l 'NAME' pyproject.toml. Hit → verdict entry-point. No hit → verdict candidate-dead, row it, disposition parked, both scan outputs saved to proof/dead-<id>.txt.
  5. Append the package's tally line to dead.md (P: S symbols, R referenced, D dynamic-ref, C candidate-dead) and flip its row to done.
Show full SKILL.md (163 more words)Show less

GATE

Pass for the invocation: the package row is done, its tally line exists, and every candidate-dead row cites a proof file containing BOTH empty scans (G2 — "dead" is only sayable with the two searches pasted). Verdict labels: referenced | dynamic-ref | entry-point | candidate-dead.

candidate-dead is the strongest claim this worker may make (X3). Deletion needs a dr-change-orchestrator tranche; the PARKED prompt says so and names the symbol, file, and proof.

Activation plant (first run)

Row a symbol that step 2 provably finds referenced (pick any imported name) as if it were a candidate; the GATE's proof-file check must refuse the row (no empty-scan proof exists). Remove the planted row, paste the refusal and the removal.

Outlets

SituationOutlet
Impulse to delete nowPARK — removal prompt, route dr-change-orchestrator
Symbol used only by testsverdict referenced, note tests-only in the row — parked prompt optional
Census too large for one windowflip the package back to pending with a resume-at: NAME note; the LEDGER carries the position

© 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-dead of AHepi/DeepReason.

Open the folder on GitHubat commit 9607fba

Compare with similar skills

Dr Audit Dead 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 Dead compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dr Audit Dead this skillAHepi/DeepReason141—~777Automated safety check: PassMIT
Dimensionsthedaviddias/Front-End-Checklist74k—~926Automated safety check: PassMIT
Dead End Pagesthedaviddias/Front-End-Checklist74k—~683Automated safety check: PassMIT
Modeling Dimension TablesPostHog/posthog40k—~1.4kAutomated safety check: PassCustom licence
Dead Dependenciesredis/RedisInsight8.9k—~1.5kAutomated safety check: PassCustom licence
Dead Codeparcadei/Continuous-Claude-v33.9k1 repos~424Automated safety check: NotesMIT

Similar skills

  • Dimensions

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing image assets, markup, and CDN or build transforms related to Set explicit width and height on images.

    74k GitHub stars~926 tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed
  • Dead End Pages

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing a site's internal link graph for dead-end pages, suggesting related-content links to add to thin or standalone pages, or reviewing CMS templates that produce…

    74k GitHub stars~683 tokensUpdated 2 days ago
    Data & AnalyticsAuto-check passed
  • Official

    Build reusable dimension / lookup tables for a star schema — country/region, timezone, currency, date, plan/product, and other descriptive attributes — on either PostHog data-warehouse views (HogQL)…

    40k GitHub stars~1.4k tokensUpdated today
    DatabasesAuto-check passed
  • Dead Dependencies

    redis/RedisInsight

    Official

    Find and safely remove unused ("dead") npm dependencies in RedisInsight using a grep + leaf-check + build-gate recipe.

    8.9k GitHub stars~1.5k tokensUpdated 4 days ago
    DatabasesAuto-check passed
  • Dead Code

    parcadei/Continuous-Claude-v3

    Find unused functions and dead code in the codebase. An agent skill from parcadei/Continuous-Claude-v3.

    3.9k GitHub starsUsed in 1 repo~424 tokens
    Auto-check: notes
  • Six Dimension Code Review

    a5c-ai/babysitter

    Structured pull-request review across six fixed dimensions — correctness, clarity, consistency, coverage, complexity, and change-scope — producing a per-dimension verdict plus severity-tagged…

    1.8k GitHub stars~700 tokensUpdated 22 days ago
    DevelopmentAuto-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 28 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 28 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 28 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 28 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 28 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 28 days ago
    Auto-check passed

Questions about Dr Audit Dead

What does Dr Audit Dead do?

Audit dimension - find code that is no longer used, via a reference census over every top-level symbol, one package per invocation. Dr Audit Dead is an agent skill from AHepi/DeepReason. Audit dimension - find code that is no longer used, via a reference census over every top-level symbol, one package per invocation.

How do I install Dr Audit Dead in Claude Code?

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

How do I install Dr Audit Dead in Codex?

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

Can I use Dr Audit Dead 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-dead -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-dead, .gemini/skills/dr-audit-dead, .github/skills/dr-audit-dead and .opencode/skills/dr-audit-dead in your project.

What does Dr Audit Dead need to run?

Going by SKILL.md and its folder, Dr Audit Dead needs the command-line tools its instructions call (rg).

Does Dr Audit Dead access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Dr Audit Dead 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 Dead use?

Dr Audit Dead 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 Dead use?

About 777 tokens (SKILL.md is roughly 3.1k 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 Dead?

Skills that share tags, products or a category with Dr Audit Dead: Dimensions (thedaviddias/Front-End-Checklist, 74k stars), Dead End Pages (thedaviddias/Front-End-Checklist, 74k stars), Modeling Dimension Tables (PostHog/posthog, 40k stars) and Dead Dependencies (redis/RedisInsight, 8.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dr Audit Dead?

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.