# Oracle Review

Run an external frontier-model referee (Claude Code -> a different vendor's frontier...

- Repository: https://github.com/pedrohcgs/claude-code-my-workflow (1676 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-09-27
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add pedrohcgs/claude-code-my-workflow --skill oracle-review -g -a claude-code -y`
Codex: `npx skills add pedrohcgs/claude-code-my-workflow --skill oracle-review -g -a codex -y`
Cursor: `npx skills add pedrohcgs/claude-code-my-workflow --skill oracle-review -g -a cursor -y`
Gemini CLI: `npx skills add pedrohcgs/claude-code-my-workflow --skill oracle-review -g -a gemini-cli -y`

## Description

Run an external frontier-model referee (Claude Code -> a different vendor's frontier model 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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Oracle review, an independent referee, then an honest triage

**Never launch a bare Oracle run.** This skill is the driver; the mechanics and the full
contract live in [`external-oracle-process.md`](../../references/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`](../credible-claims/SKILL.md) (the brief before, the claim
record after) and [`/deep-audit`](../deep-audit/SKILL.md) (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

The rest: https://github.com/pedrohcgs/claude-code-my-workflow/blob/HEAD/.claude/skills/oracle-review/SKILL.md