Agent skill

Dr Ask The Right Question

by AHepi in AHepi/DeepReason

Question discipline for working DeepReason - route every question to the cheapest authority (record, then framework, then operator), translate the operator's shorthand into typed obligations, and…

MITAuto-check passed

Install Dr Ask The Right Question

skills CLI
$ npx skills add AHepi/DeepReason --skill dr-ask-the-right-question -a claude-code

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

GitHub CLI
$ gh skill install AHepi/DeepReason dr-ask-the-right-question --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-ask-the-right-question .claude/skills/dr-ask-the-right-question && 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-ask-the-right-question
GitHub stars
141
Token cost
~2.6k tokens
SKILL.md length
1,405 words
Files
1
Skills in repo
30
Repo updated
First seen
Licence
MIT

At a glance

Question discipline for working DeepReason - route every question to the cheapest authority (record, then framework, then operator), translate the operator's shorthand into typed obligations, and…

  • Works in 6 steps: The three authorities, in cost order → Reading the operator → Ask the record first → …
  • SKILL.md covers 1. The three authorities, in…, 2. Reading the operator, 3. Ask the record first and 4. Derive before asking, plus 2 more sections
  • Calls git

What it does

Dr Ask The Right Question is an agent skill from AHepi/DeepReason. Question discipline for working DeepReason - route every question to the cheapest authority (record, then framework, then operator), translate the operator's shorthand into typed obligations, and frame uncertainty as falsifiable forks. Load whenever an operator message is ambiguous or short, whenever any workflow phase says "stop and ask", whenever evidence contradicts your expectation, and at the start of any session run by a model that has not worked this repo before.

Its SKILL.md is about 2.6k 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

  • “stop and ask”
  • “/dr-ask-the-right-question”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. The three authorities, in cost order
  2. Reading the operator
  3. Ask the record first
  4. Derive before asking
  5. Frame forks falsifiably
  6. The wrong-question table

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:

    • 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 Ask The Right Question loads about 2.6k tokens when it runs. Until then it costs about 125 tokens; SKILL.md has 1,405 words of instructions outside code blocks.

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

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). 1,405 words, ~2,583 tokens.

Download SKILL.mdSave it as .claude/skills/dr-ask-the-right-question/SKILL.md (or your agent's skills folder).
name
dr-ask-the-right-question
description
Question discipline for working DeepReason - route every question to the cheapest authority (record, then framework, then operator), translate the operator's shorthand into typed obligations, and frame uncertainty as falsifiable forks. Load whenever an operator message is ambiguous or short, whenever any workflow phase says "stop and ask", whenever evidence contradicts your expectation, and at the start of any session run by a model that has not worked this repo before.

Ask the right question

The two workflow families tell you what to PRODUCE. This skill tells you what to ASK, of whom, in what order — the reasoning that happens between an operator message and the first phase artifact. Working here fails in two ways: asking nothing (you invent facts and build on them) or asking the operator everything (their attention is the scarcest budget in the system). Both are the same mistake — a question routed to the wrong authority.

1. The three authorities, in cost order

Every question has a cheapest competent authority. Ascend only when the cheaper one genuinely cannot answer.

AuthorityAnswers questions likeCost
THE RECORD — log.jsonl, objects/, typed verdicts, blobs, instruments (verify_root, tools/root_sweep.py, tools/docs_verify.py, the gate)what happened; which value was rejected; do two instruments agree; did anything movea command
THE FRAMEWORK — CLAUDE.md, docs/map/ (Traps first), docs/ERRATA.md, the tranche ledgers (REQUEST/GOAL/PARKED), prior DELIVERY reconciliationswhat is frozen; what has gone wrong here before; what did the operator already rule; where does X livea file read
THE OPERATORgenuine forks the record and framework underdetermine; frozen-surface approval; taste on user-facing shapethe scarcest budget there is

Two rules that are always in force:

  • Cite the instrument with the number. Two instruments can both be right and disagree: the root census is 45 by direct manifest load over git ls-files and 42 rows by root_sweep.py, which scans experiments/ only. A number without its instrument is not a fact yet (docs/ERRATA.md E5, E8; DR-INV-frozen-surfaces, "The root sweep").
  • Model prose is never evidence. Yours included. If your answer to a record-question does not end in a command output or a file path, you have not asked the record yet.

2. Reading the operator

The operator writes tersely and expects the repo's context to carry the rest. Each row is a real committed exchange — look it up when unsure.

The operator saysIt meansNotCommitted evidence
"Do it" / "go ahead" after you stated a planapproval of EXACTLY that plana new vague instruction; license to widenFIX.md, experiments/2026-08-03-fix-attached-evidence-integrity ("operator approval on the stated plan: 'Do it.'")
"…as you go" ("fix documentation as you go")a STANDING grant — but you must bound it in the tranche ledger and park the restpermission to survey and rewrite everythingthat tranche's GOAL.md, "Documentation (operator-granted scope addition)"
"are you using X?" about your processa prompt: check honestly, answer plainly, and apply X now — the honest "no" is expected and usefulan accusation to deflect, or a yes/no to answer without checkingREPRO.md map-finding section of the same tranche (the answer "not until now" surfaced a missing seam)
"start an errata please" (artifact named, shape unstated)derive the shape from repo conventions (honest ledger, append-only, evidence pointers) and build it; say what you assumeda reason to ask what an errata isdocs/ERRATA.md header block
an apparent typo or wrong name ("Claude.me")resolve by repo context and proceed; note the resolution in one clausea blocker; a thing to ask aboutCLAUDE.md is the only near-match in the tree
a new instruction mid-trancheAPPEND to REQUEST.md verbatim, reconcile through dr-spec-changesomething to absorb silently into the current stepdr-change-orchestrator, "The ledger rule"

The general rule behind every row: the operator's words are AUTHORITY, so treat them the way the harness treats a record — quote them verbatim into the ledger, then interpret them in writing where the interpretation can be reviewed (REQUEST.md quotes; SPEC.md interprets). If you find yourself paraphrasing the operator from memory, you have already lost the thread.

3. Ask the record first

Before any theory about a failure or a surprise, in order:

  1. Which instrument produced this? Name it. A verdict without an instrument is hearsay (section 1).
  2. What does the typed artifact say verbatim? run-status.json state and stop_reason; the violation's check and detail; the blob under blobs/ with the rejected value. Both cycle-0 deaths in this repo's history were misattributed by readers who theorized before opening the diagnostic blob (CLAUDE.md, hard-won invariants; DR-SUB-capabilities Traps, jolt run-b4d6dfda).
  3. Do two instruments agree? rc codes, verify_root, the audit JSON, the report layer. Agreement is signal; disagreement is a finding about an INSTRUMENT, not yet about the system (ERRATA E8: a fix's predicted verdict flip appeared in verify_root but not in the sweep, because the sweep also binds the stored terminal summary — frozen evidence).
  4. Has this gone wrong here before? The covering map document's Traps section, then docs/ERRATA.md. A recurrence is the cheapest diagnosis available.
  5. What would falsify my current reading? If nothing could, it is not a reading, it is a mood.
Show full SKILL.md (639 more words)Show less

4. Derive before asking

(Absorbed from dr-decide-or-ask, kw8imd lineage, commit 86f1248e — credited, superseded here.) Before composing ANY question to the operator, derive their answer from what they have already said: this tranche's verbatim words, CLAUDE.md's standing rules, prior rulings in DELIVERY reconciliations and RESULTS conventions. This operator's recorded values: smallest correct change; fix readers, never invalidate committed records; no frozen surface without explicit approval; honesty over polish — negative results recorded as negative; a reachable defect is fixed or parked, never shipped silently.

The dominance test: would every reasonable operator holding those values choose the same option? Then the fork is false — decide, act, and record one line: "Decided without asking (dominant under your recorded values): <choice> — override any time."

What earns a question: options that survive the dominance test AND change real stakes — frozen-surface or irreversible action, >2x effort divergence between defensible readings, a conflict WITHIN the operator's own words, or taste on user-facing shape. Batch every such fork into ONE question set per tranche; lead with your recommendation and its one-sentence reason; state each option's consequence in the operator's terms (risk, cost to them, honesty of the record), including the do-nothing consequence when it leaves something reachable-broken. When the earning reason is frozen-surface contact, the question MUST embed tools/blast_radius.py's BLAST_RADIUS_RESULT_V1 result — this is section 1's own "cite the instrument with the number" rule, applied to this specific instrument (Rung G6, docs/map/INV-frozen-surfaces.md). A STOP that describes contact without pasting the gate's own computed list is words given over an inferred surface, not a disclosed one (docs/ERRATA_EXECUTOR.md, the 2026-08-09 entry; design premise: experiments/2026-08-10-change-blast-radius-analysis/REQUEST.md).

5. Frame forks falsifiably

When you are genuinely uncertain between two readings, do not pick one and build — and do not ask yet either. Write BOTH readings as alternatives the record can decide between, each with the evidence that would prove it, the way the attached-evidence tranche's GOAL.md framed W ("the writer breached; the finding is correct; the root stays invalid") against R ("the reader over-demands; the finding is spurious") before any code was read. Then collect the deciding evidence. The fork that survives IS your diagnosis; the fork that died is your "Ruled out" section. A goal written this way is decidable under either outcome, which is what makes it a goal rather than a hope (experiments/2026-08-03-fix-attached-evidence-integrity/GOAL.md, DIAGNOSIS.md).

6. The wrong-question table

Questions this repo has already paid for asking — or paid for not asking. Each cites the committed scar.

Wrong questionRight questionScar
"Which schema rule failed?" (theorizing at cycle-0)"What does the diagnostic blob say verbatim?"CLAUDE.md hard-won invariants: both cycle-0 deaths misattributed on first reading
"Is the count 42 or 45?""Which instrument, over which scope, produced each count?"ERRATA E3/E5: both were true; the census check went stale asserting one of them
"Why is this root invalid?" (accepting the finding's prose)"Does the artifact the finding names actually exist in the state?"ERRATA E6: the detail text named as missing an artifact present at seq 4
"Which artifact mentions the source record?" (shape as identity)"Which artifact carries the discriminator only the trusted writer can stamp?"DR-SUB-verification Traps: a mention-shaped predicate selected ordinary citations
"Can I reuse this passing check?""Can this check FAIL, and on whose machine?"ERRATA E7: four map checks passed only on the machine whose gitignored roots they opened
"Should I ask the operator which option they prefer?""Do the operator's recorded values already decide this?"Section 4; a false fork spends the budget the whole system is designed to conserve

Exit criterion. Before you send any question upward or act on any assumption: every question you almost asked is either answered-with-a-command (record), answered-with-a-citation (framework), decided-and-recorded (dominant), or sitting in ONE batched question set with a recommendation. Zero questions whose answer a reader of CLAUDE.md, the map's Traps, and this tranche's ledger could have given without you.

© 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-ask-the-right-question of AHepi/DeepReason.

Open the folder on GitHubat commit 9607fba

Compare with similar skills

Dr Ask The Right Question 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 Ask The Right Question compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dr Ask The Right Question this skillAHepi/DeepReason141—~2.6kAutomated safety check: PassMIT
Hermes Agent Skill AuthoringNousResearch/hermes-agent252k—~3.6kAutomated safety check: PassMIT
Configuring Oauth2 Authorization Flowmukul975/Anthropic-Cybersecurity-Skills34k—~1.7kAutomated safety check: PassApache-2.0
OmniRoute Routing CLIdiegosouzapw/OmniRoute75k—~342Automated safety check: PassMIT
Authoring Skillsvercel/next.js143k—~1kAutomated safety check: PassMIT
Routing Card Authoringagentlas-ai/Agentlas-OS1.6k—~2.7kAutomated safety check: PassApache-2.0

Similar skills

  • Hermes Agent Skill Authoring

    NousResearch/hermes-agent

    Author in-repo SKILL.md files: frontmatter and structure. An agent skill from NousResearch/hermes-agent.

    252k GitHub stars~3.6k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Configuring Oauth2 Authorization Flow

    mukul975/Anthropic-Cybersecurity-Skills

    Configures secure OAuth 2.0 authorization flows, including Authorization Code with PKCE, Client Credentials, and Device Authorization Grant, covering flow selection, PKCE implementation, token…

    34k GitHub stars~1.7k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • OmniRoute Routing CLI

    diegosouzapw/OmniRoute

    Creates, switches, and inspects OmniRoute model-routing combos, plus a suggestion command with cost and latency constraints.

    75k GitHub stars~342 tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Authoring Skills

    vercel/next.js

    Official

    How to create and maintain agent skills in .agents/skills/. An agent skill from vercel/next.js.

    143k GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Routing Card Authoring

    agentlas-ai/Agentlas-OS

    A skill your agent uses whenever a build emits or repairs .agentlas/routing-card.json — the shared card contract for the single-agent builder, the team builder, and the packager.

    1.6k GitHub stars~2.7k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • OmniRoute Combo Routing

    diegosouzapw/OmniRoute

    Manages OmniRoute routing combos through its REST API: create and update combos, choose from 19 strategies, set fallback chains, test outcomes and read metrics.

    75k GitHub stars~2.1k tokensUpdated today
    Backend & APIsAuto-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 1 mo 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 1 mo 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 1 mo 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 1 mo 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 1 mo 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 1 mo ago
    Auto-check passed

Questions about Dr Ask The Right Question

What does Dr Ask The Right Question do?

Question discipline for working DeepReason - route every question to the cheapest authority (record, then framework, then operator), translate the operator's shorthand into typed obligations, and…. Dr Ask The Right Question is an agent skill from AHepi/DeepReason. Question discipline for working DeepReason - route every question to the cheapest authority (record, then framework, then operator), translate the operator's shorthand into typed obligations, and frame uncertainty as falsifiable forks.

How do I install Dr Ask The Right Question in Claude Code?

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

How do I install Dr Ask The Right Question in Codex?

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

Can I use Dr Ask The Right Question 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-ask-the-right-question -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-ask-the-right-question, .gemini/skills/dr-ask-the-right-question, .github/skills/dr-ask-the-right-question and .opencode/skills/dr-ask-the-right-question in your project.

What does Dr Ask The Right Question need to run?

Going by SKILL.md and its folder, Dr Ask The Right Question needs the command-line tools its instructions call (git).

Does Dr Ask The Right Question 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 Ask The Right Question 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 Ask The Right Question use?

Dr Ask The Right Question 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 Ask The Right Question use?

About 2.6k tokens (SKILL.md is roughly 10k 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 Ask The Right Question?

Skills that share tags, products or a category with Dr Ask The Right Question: Hermes Agent Skill Authoring (NousResearch/hermes-agent, 252k stars), Configuring Oauth2 Authorization Flow (mukul975/Anthropic-Cybersecurity-Skills, 34k stars), OmniRoute Routing CLI (diegosouzapw/OmniRoute, 75k stars) and Authoring Skills (vercel/next.js, 143k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dr Ask The Right Question?

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.