agentleFS
hyperb1isshyperb1iss/hyperskills/skills/cross-model-review/SKILL.md

cross-model-review

Skill36 starsChanged 22 days agoMITView on GitHub

Use this skill when requesting or consuming an independent review from another model, including code, specifications, diagnoses, and factual claims. Activates on mentions of cross-model review, second opinion, independent review, different model review, confer with Codex, fact-check this doc, or check my conclusion. Use hyper-pr-review when conducting the review yourself.

  • Reads credentials

5 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

4 rules. 0 are common, 3 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 4 edited versions we read keep these.

  • 3

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Run the chosen CLI's --version and relevant --help before relying on flags.

    line 20
  2. Distinctive:

    Not permission to send source to an unapproved provider, publish a review, or modify someone else's branch.

    line 114
  3. Distinctive:

    Not protection against shared stale knowledge or a misleading brief.

    line 115
  4. Distinctive:

    Not a substitute for runtime verification, product judgment, or understanding the finding.

    line 116

“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Cross-Model Review

Use a fresh reviewer to challenge an artifact against the original request. A different model family can add useful diversity, but agreement is not proof. Preserve the user's configured model and effort unless the user explicitly requests a change. Skill guidance does not override the task's scope, existing authorization, or host permissions.

Choose the Review Surface

SituationRoute
Claude author, Codex availableScoped codex review, or codex exec for custom questions
Codex author, Claude availableclaude -p with a bounded brief and restricted tool access
Pi with the xreview extensionUse its installed /xreview interface after checking its scope semantics
Native reviewer with a different model familyUse the exposed delegation tool when authorized; inspect its actual schema
Different family unavailableFresh-context review can still help; disclose that it provides context independence only

Run the chosen CLI's --version and relevant --help before relying on flags. Tool names, wait limits, permissions, and model availability belong to the current host. An external CLI is still delegation; it does not bypass a host prohibition.

For CLI details and a copyable launcher, read references/cli-flags.md. Use references/prompts.md for the requested review mode. Load references/failure-recovery.md only when a launch fails or stalls.

Freeze a Reviewable Artifact

Capture the original request, repository path, review base, head SHA, and owned file list. For working-tree review, include staged, unstaged, and relevant untracked files. A SHA alone does not describe uncommitted work; retain the diff and file contents or a content digest. Keep unrelated work outside the packet.

ScopeEvidence to capture
BranchExact base/head plus git diff <base>...<head>
Single commitParent and commit, with git show <sha>
Working treegit status --short, staged and unstaged diffs, contents of relevant untracked files
Document or diagnosisExact artifact version, claim list, and supporting source material
Fix verificationPrior finding verbatim, claimed fix, new artifact, and regression cases

Freeze the reviewed files while the reviewer reads. Continue independent work elsewhere. If the artifact changes, identify the delta and re-review affected behavior. A metadata-only commit does not erase execution evidence for an identical tree, but an old review must never be described as examining a new SHA without a content comparison.

Write a Brief That Can Disagree

Give the reviewer the user's actual request and the artifact before your interpretation. Include necessary constraints and relevant repository instructions. Label your proposed explanation as a hypothesis. For a first independent pass, avoid supplying the conclusion you want confirmed.

A useful brief names:

  • The question and exact review scope.
  • The important behavior, interfaces, or failure modes to check.
  • Available evidence and the environment needed to reproduce it.
  • Permitted actions and required output.

Existing test results are receipts, not an instruction to trust the author. Let the reviewer repeat a decisive check or choose an independent probe. Avoid numerical confidence cutoffs, mandatory finding counts, and prompts that assume a defect exists. Read-only review does not mean tests are harmless: untrusted code needs an isolated environment without credentials.

For code, request each finding's trigger, impact, location, and evidence. For a specification, request an unmet requirement or a concrete counterexample. For a fact-check, request a verdict per claim with a primary source. For a design consult, request a recommendation and the evidence that would change it; a consultation needs no PASS.

Launch Once, Retain the Handle

For long Claude CLI reviews, use scripts/run_claude_review.py and inspect its saved status with scripts/review_status.py. Read references/observable-reviews.md for launch, authentication, scope, and recovery details. The helper retains events and stderr without requiring another reviewer process. Native host progress tools or a direct CLI capture remain suitable when they provide enough visibility.

Capture the full output to a unique file, and print that path before launch. Keep prompt content in a file or single-quoted heredoc. Do not interpolate untrusted text into shell code. A quoted "$(cat "$review_prompt")" reads a trusted prompt file as one argument; an unquoted heredoc can execute embedded shell syntax.

A running process or cell ID means the job is active. Poll that same handle with the host's supported wait operation. Wait duration controls when the host yields, not whether the reviewer succeeds. Use legal wait values and leave room for user updates; do not hardcode a five-minute initial wait into every harness.

Do not pipe a live review through head or tail as the sole capture. head can close the pipe early; tail commonly withholds output until EOF and discards earlier findings. Read the saved result after completion. Silence, transcript size, and elapsed time do not establish a verdict.

Authentication must follow the user's intended provider and billing route. For a subscription-backed Claude review, remove an inherited ANTHROPIC_API_KEY from that child process when it would select unintended API billing. Preserve it for an explicitly API-backed workflow. Never print credentials or change persistent auth configuration to make a review run.

Adjudicate Findings

A finding is a claim until its cited path and trigger survive a disproof attempt. Inspect the exact artifact reviewed before changing code. A reviewer can identify the wrong similarly named file, invent a CLI flag, or flag behavior already fixed at HEAD.

DispositionRequired evidence
FixA real defect within the authorized scope, with a reproducible or fully traced cause
DeclineThe counterexample, contract, or intentional tradeoff that refutes the finding
Follow-upA verified issue outside the change's causal scope
UnresolvedThe missing environment, fact, or decision and the check that would settle it

Repeat passes of one model and distinct review lenses add coverage of their own: in one exploratory vulnerability study, four passes of a single model found about as many issues as one pass from each of four families. Treat them as diversity alongside a second family, not as substitutes for it. Agreement among any of them increases investigation priority; it does not promote a candidate to confirmed.

A missing grep match does not establish absence. Compare base and head when claiming the change introduced a defect. Static tracing can confirm a deterministic error if the complete path is established; report the actual evidence tier without pretending execution occurred.

Fix verified issues and inspect the fix for new regressions. Preserve reviewer independence: switch explicitly from review to implementation when the user authorized both. Do not let a read-only reviewer silently edit the artifact it is judging.

Converge on Evidence

One pass is the default. Run a second only to close a blocking finding whose fix is itself non-trivial; for a small fix, the coordinator verifies closure by reading the diff. Keep a compact findings ledger when a second round is needed. Each entry has an identity, evidence, disposition, and verification status. Subsequent briefs carry the prior finding verbatim and the changed artifact so the reviewer checks closure rather than rediscovering the conversation.

A second pass asks only for closure of the carried findings. If the same objection returns without new evidence, settle the underlying contract or report the remaining disagreement. Avoid open-ended loops driven by a nonzero suggestion count. Nonblocking preferences do not expand an authorized fix into a redesign.

VerdictMeaning
PASSThe requested review finished, required checks ran, and no blocking finding remains in the reviewed scope
NEEDS_CHANGESAt least one supported blocking defect remains
INCONCLUSIVERequired coverage or evidence is unavailable; include useful partial findings

An interrupted review cannot grant PASS over unread material. Process exit zero means the CLI completed; the substantive report determines the review verdict. Distinguish model review, static analysis, and executed checks in the receipt. None replaces the others.

Evidence and Maintenance

Reviewed 2026-09-04 and 2026-10-27; sources and their limits are in references/evidence.md.

Anti-Patterns

Anti-patternCorrection
Treating --allowedTools as a sandboxRestrict available tools and apply the host's actual isolation boundary
Relaunching after a yieldPoll the existing handle; recover output before considering a retry
Requiring a specific model or maximum effortPreserve user configuration; improve scope before changing resources
Promoting consensus to confirmationRun the disproof or trace the complete behavior
Passing a review with missing required checksReport INCONCLUSIVE with the remaining evidence gap
Treating every suggestion as mandatoryFix supported defects within scope; record optional improvements separately
Replacing the user's request with the author's summaryInclude the original request and invite interpretation challenges

What This Skill is NOT

  • Not permission to send source to an unapproved provider, publish a review, or modify someone else's branch.
  • Not protection against shared stale knowledge or a misleading brief.
  • Not a substitute for runtime verification, product judgment, or understanding the finding.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.