Oracle review — an independent referee, then an honest triage
SkillAI & modelsRun an external frontier-model referee (Claude Code -> GPT-5.6 Sol Pro via the Oracle CLI) on a paper, proof, estimator, or replication package -- and adjudicate what comes back. Use when the user says "send this to oracle", "get an external review", "run a referee round", "deep-check this proof", or before a submission when an independent second opinion is worth more than another in-house pass. Never launches bare: brief first, evidence-forcing prompt, coverage manifest, then CONFIRMED/REFUTED/DOWNGRADED triage.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Oracle review — an independent referee, then an honest triage skill
What this skill tells your AI
The instructions your AI receives, as published by pedrohcgs/claude-code-my-workflow in .claude/skills/oracle-review/SKILL.md and read by ahel’s review.
Never launch a bare Oracle run. This skill is the driver; the mechanics and the full
contract live in external-oracle-process.md.
Read it before the first run in a project — it carries setup, flags, artifact layout, the
payload cliff, and the failure modes that have actually cost runs.
Compose with /credible-claims (the brief before, the claim
record after) and /deep-audit (exhaustive in-house coverage first,
so the oracle is confirmation, not discovery).
1. Brief before launch (5 lines)
- Question — what must this review answer? (correctness audit? venue-referee simulation? confirm N named fixes cleared?)
- Scope — what is IN, and what is HELD (standing rulings; list them so triage can filter).
- Completion — what verdict or evidence ends this run.
- Required evidence — findings carry location + failing case, or they do not count.
- Escalation — which finding types come back to the user before any fix: estimand changes, assumption concessions, reporting-language downgrades.
2. Assign coverage — never let the referee sample
Maintain a statement inventory and a cross-round coverage ledger. Each round assigns what to audit and requires the referee to report what it actually verified, so union coverage reaches 100% instead of drifting toward whatever is easiest to read.
3. Launch
Mechanics, flags, and gotchas: the reference, §2–§3. Smoke-test first; check --files-report
against the payload cliff; a run with no conversation URL never happened.
4. Triage — adjudicate, never ingest
Every finding is a CANDIDATE. Hand the batch to
/adjudicate-review: judge each against the actual text,
compute the computable first, filter the HELD list, and assign
CONFIRMED / REFUTED / DOWNGRADED.
Oracle agreeing with your own reading is not independent confirmation — different models correlate on the same wrong answer.
5. Fix, converge, record
Batch every confirmed fix in one pass, re-verify, then run at most one confirmation round. Converged when a round returns no new CONFIRMED correctness defect — only held items and exposition taste. Close with a claim record: what was fixed (location + evidence), what was REFUTED and why, what is unresolved, and which decisions are the user's.
Cross-references
external-oracle-process.md— the mechanics, and the five credibility questions the findings must be sorted into/adjudicate-review— the triage half/credible-claims— brief before, claim record after/deep-audit— in-house coverage firstverification-ladder.md— rung 6; why the oracle comes last
Signals
- GitHub stars
- 2k
- Forks
- 3k
- Last commit
- Aug 2026
Advanced
- Catalog kind
- skill
- Gateway key
oracle-review- Source
- github.com/pedrohcgs/claude-code-my-workflow