Agent skill

Dr Audit Spec Drift

by AHepi in AHepi/DeepReason

Audit dimension - find where the code deviates from the spec series and where shipped surface is spec-silent, by a two-direction term census.

MITAuto-check passed

Install Dr Audit Spec Drift

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

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

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

At a glance

Audit dimension - find where the code deviates from the spec series and where shipped surface is spec-silent, by a two-direction term census.

  • Works in 5 steps: SPEC term census → For each SPEC term: rg -l -w ''… → TREE surface census, three lists with… → …
  • SKILL.md covers Operations, GATE, Activation plant (first run) and Outlets
  • Calls rg

What it does

Dr Audit Spec Drift is an agent skill from AHepi/DeepReason. Audit dimension - find where the code deviates from the spec series and where shipped surface is spec-silent, by a two-direction term census. Invoked by dr-audit-orchestrator when spec-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.

The licence is MIT.

Example prompts

  • “/dr-audit-spec-drift”

Workflow steps

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

  1. SPEC term census
  2. For each SPEC term: rg -l -w '' src/deepreason/ (identifiers)
  3. TREE surface census, three lists with proofs
  4. For each TREE surface item: rg -l -F '' docs/harness-spec-*.md.
  5. Write spec-drift.md: two tables (one per direction) with count

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 Spec Drift loads about 752 tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 373 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
~752

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). 373 words, ~752 tokens.

Download SKILL.mdSave it as .claude/skills/dr-audit-spec-drift/SKILL.md (or your agent's skills folder).
name
dr-audit-spec-drift
description
Audit dimension - find where the code deviates from the spec series and where shipped surface is spec-silent, by a two-direction term census. Invoked by dr-audit-orchestrator when spec-drift.md is missing.

Audit: code vs spec

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

Two directions, both mechanical:

  • SPEC→TREE: a term the spec names that the tree no longer honors = the code deviates from spec.
  • TREE→SPEC: a shipped public surface the spec never mentions = the spec is behind the code.

The spec series is every docs/harness-spec-*.md (base + all amendments — read ALL amendments; later files supersede earlier ones on conflict, so verify a term against the newest file naming it).

Operations

  1. SPEC term census: rg -o -N '\x60[A-Za-z_][A-Za-z0-9_.:-]*\x60' docs/harness-spec-*.md | sort -u > proof/spec-terms.txt plus every ##-level heading noun phrase. This is the SPEC list.
  2. For each SPEC term: rg -l -w '<term>' src/deepreason/ (identifiers) or rg -l '<term>' src/ docs/map/ (concept phrases). Zero hits → verdict spec-orphan (spec names it, tree does not have it), one row each with the scan saved. Hits → tally only.
  3. TREE surface census, three lists with proofs: a. CLI flags: rg -o -N '"--[a-z][a-z0-9-]*"' src/deepreason/cli/main.py | sort -u b. Config fields: rg -o -N '^ [A-Z][A-Z0-9_]*:' src/deepreason/config.py | sort -u c. Typed error/refusal strings: rg -o -N '"[A-Z][A-Z0-9_]{6,}"' src/deepreason/run_manifest.py src/deepreason/preparation.py | sort -u
  4. For each TREE surface item: rg -l -F '<item>' docs/harness-spec-*.md. Zero hits → verdict spec-silent (shipped, undocumented in spec), one row each. Batch rows by feature, not per flag, when one tranche shipped them together (the row names the batch and lists members).
  5. Write spec-drift.md: two tables (one per direction) with count lines. The spec-silent table's parked prompt is a spec-amendment draft request (append-only amendment file, never an edit to existing spec text), route dr-change-orchestrator.
Show full SKILL.md (109 more words)Show less

GATE

Pass: proofs exist for both censuses; every spec-orphan and every spec-silent row cites its scan file; count lines match row counts. Verdict labels: spec-orphan | spec-silent | covered.

Activation plant (first run)

Append a fabricated term row to the SPEC list copy in proof/spec-terms.txt; step 2 must produce a spec-orphan verdict for it (zero hits). Delete the fabricated row, note the plant in ACTIVATION.md.

Outlets

SituationOutlet
Impulse to draft the amendment nowPARK — amendment prompt, route dr-change-orchestrator
A spec term superseded by a newer amendmentverdict covered, row notes the superseding file
Term ambiguous between identifier and conceptrun both scan shapes, row the weaker result, save both proofs

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

Open the folder on GitHubat commit 9607fba

Compare with similar skills

Dr Audit Spec 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 Spec Drift compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dr Audit Spec Drift this skillAHepi/DeepReason141—~752Automated safety check: PassMIT
Dimensionsthedaviddias/Front-End-Checklist74k—~926Automated safety check: PassMIT
Driftalsk1992/CloddsBot3k—~299Automated safety check: PassMIT
Detecting Container Drift At Runtimemukul975/Anthropic-Cybersecurity-Skills34k—~2.1kAutomated safety check: PassApache-2.0
Harness Drift From Historyruvnet/ruflo74k—~632Automated safety check: NotesMIT
Modeling Dimension TablesPostHog/posthog40k—~1.4kAutomated safety check: PassCustom licence

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 4 days ago
    Frontend & DesignAuto-check passed
  • Drift

    alsk1992/CloddsBot

    Drift Protocol - perpetuals and prediction markets on Solana

    3k GitHub stars~299 tokensUpdated 8 days ago
    Auto-check passed
  • Detecting Container Drift At Runtime

    mukul975/Anthropic-Cybersecurity-Skills

    Detects unauthorized runtime drift in containers by monitoring binary execution, filesystem changes, and configuration deviation from the original immutable image, using Falco and Microsoft Defender…

    34k GitHub stars~2.1k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed
  • One-command drift detection. An agent skill from ruvnet/ruflo.

    74k GitHub stars~632 tokensUpdated today
    DevelopmentAuto-check: notes
  • 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
  • SEO Drift

    sickn33/agentic-awesome-skills

    Snapshot a site's SEO state and detect ranking, indexation, metadata, canonical, robots, schema, and on-page regressions over time.

    47k GitHub starsUsed in 1 repo~1.8k tokens
    Marketing & SEOAuto-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 29 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 29 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 29 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 29 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 29 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 29 days ago
    Auto-check passed

Questions about Dr Audit Spec Drift

What does Dr Audit Spec Drift do?

Audit dimension - find where the code deviates from the spec series and where shipped surface is spec-silent, by a two-direction term census. Dr Audit Spec Drift is an agent skill from AHepi/DeepReason. Audit dimension - find where the code deviates from the spec series and where shipped surface is spec-silent, by a two-direction term census.

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

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

How do I install Dr Audit Spec Drift in Codex?

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

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

What does Dr Audit Spec Drift need to run?

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

Does Dr Audit Spec Drift 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 Spec 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 Spec Drift use?

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

About 752 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 Spec Drift?

Skills that share tags, products or a category with Dr Audit Spec Drift: Dimensions (thedaviddias/Front-End-Checklist, 74k stars), Drift (alsk1992/CloddsBot, 3k stars), Detecting Container Drift At Runtime (mukul975/Anthropic-Cybersecurity-Skills, 34k stars) and Harness Drift From History (ruvnet/ruflo, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dr Audit Spec 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.