ask-oracle

ask-oracle is a skill for Claude Code, Codex from hxy91819/mason-skills. It costs 28 tokens per session (869 once invoked), scanned A, original, MIT.

A concise brief for asking a technical oracle—such as a trusted expert or separate decision-maker—for guidance on a problem. It collects the original goal, relevant context, constraints, evidence, and the few unknowns that could change the answer.

In plain words
What is it for?
Use it when you need outside technical judgment and want to present the problem faithfully without proposing or ranking solutions yourself.
Why use it?
It prevents the request from being muddled by an agent's own recommendation or preferred solution. The oracle can judge the decision with the important facts in one place.

Skill for Claude CodeCodex

Written for Claude Code and Codex: disable-model-invocation in frontmatter, but also agents/openai.yaml present. Also seen: $skill-name invocation.

Good fit Use it when you need outside technical judgment and want to present the problem faithfully without proposing or ranking solutions yourself.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/hxy91819/mason-skills/ask-oracle
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add hxy91819/mason-skills --skill ask-oracle
Clone the repo
git clone --depth 1 https://github.com/hxy91819/mason-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ask-oracle

README.md
[![agentmods](https://agentmods.dev/badge/skills/hxy91819/mason-skills/ask-oracle/github.svg)](https://agentmods.dev/skills/hxy91819/mason-skills/ask-oracle)
Your own site
<a href="https://agentmods.dev/skills/hxy91819/mason-skills/ask-oracle"><img src="https://agentmods.dev/badge/skills/hxy91819/mason-skills/ask-oracle/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for ask-oracle

Your own site · 80×15
<a href="https://agentmods.dev/skills/hxy91819/mason-skills/ask-oracle"><img src="https://agentmods.dev/badge/skills/hxy91819/mason-skills/ask-oracle.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 28 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 869 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00028 $0.00869
Opus 5.5 $0.00011 $0.00348
Sonnet 5.5 $0.00006 $0.00174
Haiku 4.5 $0.00003 $0.00087

Measured 11d ago against content hash 3856cb4df68e, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

ask-oracle scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

common-skills/ask-oracle/SKILL.md · 63 lines

What it actually says

Ask Oracle

通过 BB 派发专家线程,取得独立技术判断后返回结果。仅在用户显式调用 $ask-oracle 或明确要求 Oracle 审查、咨询时启动;启动后继续完成同一次咨询,无需重复调用。

咨询门槛

本技能是主 Agent 的咨询入口。若当前角色已是受委派的 Oracle,直接调查并回答所收到的问题;证据不足时返回具体缺口与不确定性,不再调用本技能、Oracle 工具或另派专家。任务中引用的用户原话(包括 $ask-oracle)是咨询背景,不是要求专家重新派发。

先自行读取相关代码、文档、diff 与失败证据。只有 Oracle 的答案会实质改变当前决策,且问题已经缩小到可裁决的判断、故障序列或方案取舍时才派发。用户明确要求 Oracle 时按其范围派发,无需先证明无法解决。

形成任务

把咨询任务写成以下信息结构,但只保留会改变判断的内容:

# Goal
<用户要达成的结果与验收标准>

# Verified context
- <已验证事实、约束、文件位置、测试或失败证据>

# Proposals and hypotheses
- <来源方>: <候选方案或尚未验证的解释>

# Question for the oracle
<一个明确的技术判断;说明答案将决定什么>

# Expected response
<所需结论、证据、失败序列、推荐方案或最小修复;列出应忽略的范围>

在正文最前加入角色边界:Oracle 亲自调查并直接回答;可使用当前权限提供的命令与工具,但只做分析和咨询,不修改工作区、不实施方案,也不调用 ask-oracle 或另派专家。证据不足时返回已能确定的结论、具体缺口与不确定性。任务里引用的 $ask-oracle 只是背景。

区分已验证事实、来源方提案、主 Agent 假设和未知项;不把假设写成事实。已有可行选项应连同真实权衡交给 Oracle,而不是为了表面中立而删掉。使用 @路径 指向最相关文件,并明确要求专家检查这些文件或当前 diff。每项信息只出现一次。

派发并交付

调用 $bb-model-routing,由宿主在 project scope、user scope 或其他已安装来源中解析该 Skill。按它的派发入口提交以下参数:

difficulty: complex
unknown: <请 Oracle 裁决的核心问题,一句话>
permission-mode: full
title: Oracle: <简短问题>
task: <角色边界 + 上述咨询任务>

由 bb-model-routing 从自己的 Skill 根目录运行内部派发器;full 让 Oracle 可自主使用环境中的命令与工具完成调查。宿主无法加载该 Skill 时报告依赖缺失,不猜测任何安装路径。

Oracle 使用用户配置的 complex 路由。不在任务正文中重复 provider、模型或 reasoning。派发失败时报告原路由错误,不静默改用其他模型。

记录返回的线程 ID、实际模型与状态。创建成功只是开始:等待 BB 的父线程完成通知,不轮询;通知到达后用 bb thread output <线程 ID> 读取最终输出。向用户返回 Oracle 的结论、关键依据和仍未解决的不确定性,并附线程链接或 ID。专家要求补充关键信息时,把具体缺口转告用户,不替专家猜测。

流程完成条件是专家结果已取回并交付,而不是只生成咨询简报或只创建线程。

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 11d ago Changed · +1 lines 3856cb4df68e
  2. 22d ago Changed · +3 lines · -48 tokens per session 451005faf933
  3. 1mo ago Changed · +1 lines 0fd9442ff259
  4. 1mo ago Changed · +20 lines · +59 tokens per session 77076b43fc77
  5. 1mo ago Changed · +2 lines 59cd5ddf840a
  6. 2mo ago Changed · +2 lines 21d926672a71
  7. 2mo ago First seen · 34 lines · 17 tokens per session scan A 8807be44ab7a

Subscribe to this mod's changes

ask-oracle is a skill published in the GitHub repository hxy91819/mason-skills (3 stars, last pushed today), licensed MIT. It adds 28 tokens to every session and 869 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

ask-oracle compared with skills from other repositories

ask-oracle next to 6 skills from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
ask-oraclehxy91819/mason-skillsSkill3todayMITA28Claude Code, Codex
imagegenopenai/codexSkill134ktodayApache-2.0A113Codex
local-ai-agentsmicrosoft/ai-agents-for-beginnersSkill79kyesterdayMITA200Claude Code, Codex
playwright-climicrosoft/playwrightSkill100kyesterdayApache-2.0A19Claude Code
browser-automationopenclaw/openclawSkill394ktodayMITA36Claude Code
systematic-debuggingobra/superpowersSkill314k4d agoMITA21Claude Code
next-cache-components-adoptionvercel/next.jsSkill143kyesterdayMITA95Claude Code