Hermes Agent Skill Authoring
NousResearch/hermes-agent
Author in-repo SKILL.md files: frontmatter and structure. An agent skill from NousResearch/hermes-agent.
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…
$ npx skills add AHepi/DeepReason --skill dr-ask-the-right-question -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install AHepi/DeepReason dr-ask-the-right-question --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ 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-srcUse ~/.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/
Install the "dr-ask-the-right-question" agent skill from https://github.com/AHepi/DeepReason/tree/main/.claude/skills/dr-ask-the-right-question into .claude/skills/dr-ask-the-right-question/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dr-ask-the-right-question", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/AHepi/DeepReason/tree/main/.claude/skills/dr-ask-the-right-questionType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add AHepi/DeepReason --skill dr-ask-the-right-question -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install AHepi/DeepReason dr-ask-the-right-question --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AHepi/DeepReason.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/dr-ask-the-right-question .agents/skills/dr-ask-the-right-question && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "dr-ask-the-right-question" agent skill from https://github.com/AHepi/DeepReason/tree/main/.claude/skills/dr-ask-the-right-question into .agents/skills/dr-ask-the-right-question/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dr-ask-the-right-question", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add AHepi/DeepReason --skill dr-ask-the-right-question -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install AHepi/DeepReason dr-ask-the-right-question --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AHepi/DeepReason.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/dr-ask-the-right-question .cursor/skills/dr-ask-the-right-question && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "dr-ask-the-right-question" agent skill from https://github.com/AHepi/DeepReason/tree/main/.claude/skills/dr-ask-the-right-question into .cursor/skills/dr-ask-the-right-question/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dr-ask-the-right-question", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/AHepi/DeepReason.git --path .claude/skills/dr-ask-the-right-question--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add AHepi/DeepReason --skill dr-ask-the-right-question -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install AHepi/DeepReason dr-ask-the-right-question --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AHepi/DeepReason.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/dr-ask-the-right-question .gemini/skills/dr-ask-the-right-question && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "dr-ask-the-right-question" agent skill from https://github.com/AHepi/DeepReason/tree/main/.claude/skills/dr-ask-the-right-question into .gemini/skills/dr-ask-the-right-question/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dr-ask-the-right-question", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install AHepi/DeepReason dr-ask-the-right-questionInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add AHepi/DeepReason --skill dr-ask-the-right-question -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/AHepi/DeepReason.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/dr-ask-the-right-question .github/skills/dr-ask-the-right-question && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "dr-ask-the-right-question" agent skill from https://github.com/AHepi/DeepReason/tree/main/.claude/skills/dr-ask-the-right-question into .github/skills/dr-ask-the-right-question/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dr-ask-the-right-question", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add AHepi/DeepReason --skill dr-ask-the-right-question -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install AHepi/DeepReason dr-ask-the-right-question --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AHepi/DeepReason.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/dr-ask-the-right-question .opencode/skills/dr-ask-the-right-question && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "dr-ask-the-right-question" agent skill from https://github.com/AHepi/DeepReason/tree/main/.claude/skills/dr-ask-the-right-question into .opencode/skills/dr-ask-the-right-question/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dr-ask-the-right-question", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
dr-ask-the-right-questionQuestion 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. 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.
6 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 9607fba. It shows what the files ask for, not the result of running them.
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.
Shell commands in SKILL.md call:
gitFrom the folder's file list and the shell code blocks in SKILL.md.
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.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
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.
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.
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.
The full file from AHepi/DeepReason at commit 9607fba, republished under its MIT licence (© AHepi). 1,405 words, ~2,583 tokens.
.claude/skills/dr-ask-the-right-question/SKILL.md (or your agent's skills folder).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.
Every question has a cheapest competent authority. Ascend only when the cheaper one genuinely cannot answer.
| Authority | Answers questions like | Cost |
|---|---|---|
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 move | a command |
THE FRAMEWORK — CLAUDE.md, docs/map/ (Traps first), docs/ERRATA.md, the tranche ledgers (REQUEST/GOAL/PARKED), prior DELIVERY reconciliations | what is frozen; what has gone wrong here before; what did the operator already rule; where does X live | a file read |
| THE OPERATOR | genuine forks the record and framework underdetermine; frozen-surface approval; taste on user-facing shape | the scarcest budget there is |
Two rules that are always in force:
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").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 says | It means | Not | Committed evidence |
|---|---|---|---|
| "Do it" / "go ahead" after you stated a plan | approval of EXACTLY that plan | a new vague instruction; license to widen | FIX.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 rest | permission to survey and rewrite everything | that tranche's GOAL.md, "Documentation (operator-granted scope addition)" |
| "are you using X?" about your process | a prompt: check honestly, answer plainly, and apply X now — the honest "no" is expected and useful | an accusation to deflect, or a yes/no to answer without checking | REPRO.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 assumed | a reason to ask what an errata is | docs/ERRATA.md header block |
| an apparent typo or wrong name ("Claude.me") | resolve by repo context and proceed; note the resolution in one clause | a blocker; a thing to ask about | CLAUDE.md is the only near-match in the tree |
| a new instruction mid-tranche | APPEND to REQUEST.md verbatim, reconcile through dr-spec-change | something to absorb silently into the current step | dr-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.
Before any theory about a failure or a surprise, in order:
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).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).docs/ERRATA.md. A recurrence is the cheapest diagnosis
available.(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).
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).
Questions this repo has already paid for asking — or paid for not asking. Each cites the committed scar.
| Wrong question | Right question | Scar |
|---|---|---|
| "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
Just SKILL.md in .claude/skills/dr-ask-the-right-question of AHepi/DeepReason.
Open the folder on GitHubat commit 9607fba
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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Dr Ask The Right Question this skillAHepi/DeepReason | 141 | — | ~2.6k | Automated safety check: Pass | MIT | |
| Hermes Agent Skill AuthoringNousResearch/hermes-agent | 252k | — | ~3.6k | Automated safety check: Pass | MIT | |
| Configuring Oauth2 Authorization Flowmukul975/Anthropic-Cybersecurity-Skills | 34k | — | ~1.7k | Automated safety check: Pass | Apache-2.0 | |
| OmniRoute Routing CLIdiegosouzapw/OmniRoute | 75k | — | ~342 | Automated safety check: Pass | MIT | |
| Authoring Skillsvercel/next.js | 143k | — | ~1k | Automated safety check: Pass | MIT | |
| Routing Card Authoringagentlas-ai/Agentlas-OS | 1.6k | — | ~2.7k | Automated safety check: Pass | Apache-2.0 |
NousResearch/hermes-agent
Author in-repo SKILL.md files: frontmatter and structure. An agent skill from NousResearch/hermes-agent.
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…
diegosouzapw/OmniRoute
Creates, switches, and inspects OmniRoute model-routing combos, plus a suggestion command with cost and latency constraints.
vercel/next.js
How to create and maintain agent skills in .agents/skills/. An agent skill from vercel/next.js.
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.
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.
AHepi/DeepReason
Orchestrate a Steven Pinker-grounded workflow for teaching, explanatory writing, or material that must do both.
AHepi/DeepReason
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.
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…
AHepi/DeepReason
Build a battery of concrete instances BEFORE writing or evaluating any definition, pin, or semantic clause (Reed step 1).
AHepi/DeepReason
Rules for writing, editing, and retiring skill and workflow files for LLM agents.
AHepi/DeepReason
Entry point for any DeepReason problem. 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…. 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.
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.
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.
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.
Going by SKILL.md and its folder, Dr Ask The Right Question needs the command-line tools its instructions call (git).
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.
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.
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.
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.
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.
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.