Oracle review — an independent referee, then an honest triage

SkillAI & models

Run 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.

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

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