Agent skill

Dr Audit Broken

by AHepi in AHepi/DeepReason

Audit dimension - find broken code by running every committed verification instrument and tabling deltas against the recorded baselines.

MITAuto-check passedTesting & QA

Install Dr Audit Broken

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

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

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

At a glance

Audit dimension - find broken code by running every committed verification instrument and tabling deltas against the recorded baselines.

  • Works in 6 steps: pip install -e . --break-system-packages… → python -m pytest tests/ -q -n 4 —… → python tools/docs_verify.py — compare… → …
  • Testing & QA work in your project
  • SKILL.md covers Operations, GATE, Activation plant (first run) and Outlets
  • Calls python, pip and git

What it does

Dr Audit Broken is an agent skill from AHepi/DeepReason. Audit dimension - find broken code by running every committed verification instrument and tabling deltas against the recorded baselines. Invoked by dr-audit-orchestrator when broken.md is missing.

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

It sits in Testing & QA. It works with Python and pytest. The licence is MIT.

When your agent uses it

  • Testing & QA work in your project

Example prompts

  • “/dr-audit-broken”

Requirements

  • Python 3

Workflow steps

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

  1. pip install -e . --break-system-packages -q and
  2. python -m pytest tests/ -q -n 4 — compare failures to the
  3. python tools/docs_verify.py — compare failing checks to the
  4. python scripts/wheel_smoke.py then
  5. RETIRED (operator ruling 2026-08-22, CLAUDE.md §Build and test)
  6. Write broken.md: the table of every non-baseline delta, one row

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
    • pip
    • git

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

  • Network

    No URLs in SKILL.md. Its commands use pip and 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 Broken loads about 690 tokens when it runs. Until then it costs about 53 tokens; SKILL.md has 338 words of instructions outside code blocks.

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

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). 338 words, ~690 tokens.

Download SKILL.mdSave it as .claude/skills/dr-audit-broken/SKILL.md (or your agent's skills folder).
name
dr-audit-broken
description
Audit dimension - find broken code by running every committed verification instrument and tabling deltas against the recorded baselines. Invoked by dr-audit-orchestrator when broken.md is missing.

Audit: broken code

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

Broken means: an instrument's output moved from docs/AUDIT_BASELINES.md §Instruments. The instruments define broken; this worker adds no judgment of its own (G3).

Operations

  1. pip install -e . --break-system-packages -q and pip install pytest pytest-xdist jsonschema --break-system-packages -q. Run every command below with python -m where applicable; save each full output to proof/broken-<n>.txt.
  2. python -m pytest tests/ -q -n 4 — compare failures to the baseline failure list. Re-run any non-baseline failure serially (python -m pytest <nodeid> -q) before rowing it: still red → verdict broken; green serially → verdict flaky (row it; flaky is a finding unless baseline-listed).
  3. python tools/docs_verify.py — compare failing checks to the baseline list. Non-baseline failure → verdict broken (the check or the code it pins moved; the fix tranche decides which).
  4. python scripts/wheel_smoke.py then python -u scripts/wheel_operational_smoke.py — any non-zero exit → verdict broken, target = the pin named in the output.
  5. RETIRED (operator ruling 2026-08-22, CLAUDE.md §Build and test): the root sweep is no longer an audit instrument. Do NOT run tools/root_sweep.py. Write proof/broken-sweep.txt containing the single line retired 2026-08-22 — see CLAUDE.md so the proof count stays auditable.
  6. Write broken.md: the table of every non-baseline delta, one row per finding, columns as the LEDGER. Matches baseline exactly → the table plus one line: all instruments at baseline, with the five proof files as the required proof of looking (G2).

GATE

Pass: every instrument ran (four live instruments + the retirement marker file = five proof files) AND every non-baseline delta has a LEDGER row with disposition parked. Verdict labels: broken | flaky | baseline.

Activation plant (first run)

Edit one assert in a copy of a passing test to a false constant, run step 2 scoped to that file, paste the red output, git checkout -- the file, paste the clean status.

Outlets

SituationOutlet
Any fix impulsePARK — prompt in PARKED.md, route deepreason-orchestrator
Instrument itself crashesrow verdict broken, target = instrument, PARK
Baseline looks wrongrow it, PARK a baseline-correction prompt (PRECEDENCE 2)

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

Open the folder on GitHubat commit 9607fba

Compare with similar skills

Dr Audit Broken 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 Broken compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dr Audit Broken this skillAHepi/DeepReason141—~690Automated safety check: PassMIT
Adk Verify Snippetsgoogle/adk-python22k—~1.4kAutomated safety check: PassApache-2.0
Hermetic Python Unit TestsdimensionalOS/dimos4.6k—~1.4kAutomated safety check: PassCustom licence
ONNX Runtime Test Runnermicrosoft/onnxruntime22k—~1.8kAutomated safety check: PassMIT
Simple Modern Uvjlevy/simple-modern-uv301—~1.9kAutomated safety check: PassMIT
Test Coverage Reviewareed1192/finance-news-aggregator149—~2.6kAutomated safety check: PassMIT

Similar skills

  • Adk Verify Snippets

    google/adk-python

    Official

    Checks that every Python code block in a Markdown file actually compiles and runs, by extracting each block to a temporary file, executing it in an isolated subprocess, and writing a pass/fail…

    22k GitHub stars~1.4k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Hermetic Python Unit Tests

    dimensionalOS/dimos

    Rules for writing, fixing and reviewing pytest unit tests that are hermetic: behavior-focused, deterministic, isolated and cheap to run.

    4.6k GitHub stars~1.4k tokensUpdated today
    Testing & QAAuto-check passed
  • ONNX Runtime Test Runner

    microsoft/onnxruntime

    Official

    Runs and debugs ONNX Runtime tests: Google Test executables for C++ and unittest or pytest for Python, with filters and build-directory guidance.

    22k GitHub stars~1.8k tokensUpdated today
    Testing & QAAuto-check passed
  • Simple Modern Uv

    jlevy/simple-modern-uv

    Start, selectively modernize, fully migrate, or update Python projects using simple-modern-uv practices: uv, ruff, BasedPyright, pytest, GitHub Actions CI, and tag-driven PyPI publishing.

    301 GitHub stars~1.9k tokensUpdated 1 mo ago
    Testing & QAAuto-check passed
  • Test Coverage Review

    areed1192/finance-news-aggregator

    Audit, plan, write, and verify unit tests for Python projects using pytest.

    149 GitHub stars~2.6k tokensUpdated 5 mo ago
    Testing & QAAuto-check passed
  • Official

    Runs the ONNX Runtime transformers Python tests against a GPU wheel and proves the cuDNN flash attention path was used rather than a silent fallback.

    22k GitHub stars~2.9k tokensUpdated today
    Testing & QAAuto-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

Works with

Categories

Questions about Dr Audit Broken

What does Dr Audit Broken do?

Audit dimension - find broken code by running every committed verification instrument and tabling deltas against the recorded baselines. Dr Audit Broken is an agent skill from AHepi/DeepReason. Audit dimension - find broken code by running every committed verification instrument and tabling deltas against the recorded baselines.

When should I use Dr Audit Broken?

Dr Audit Broken fits situations like: testing & QA work in your project.

How do I install Dr Audit Broken in Claude Code?

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

How do I install Dr Audit Broken in Codex?

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

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

What does Dr Audit Broken need to run?

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

Does Dr Audit Broken access the network?

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

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

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

About 690 tokens (SKILL.md is roughly 2.8k 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 Broken?

Skills that share tags, products or a category with Dr Audit Broken: Adk Verify Snippets (google/adk-python, 22k stars), Hermetic Python Unit Tests (dimensionalOS/dimos, 4.6k stars), ONNX Runtime Test Runner (microsoft/onnxruntime, 22k stars) and Simple Modern Uv (jlevy/simple-modern-uv, 301 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dr Audit Broken?

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.