ootbt-dual-judge-markdown-review

Reviews Markdown plans and implementation reports with two independent adversarial AI judges.

Updated Aug 20, 2026
One-click install
npx skills add https://github.com/nowrap/ootbt-skills --skill ootbt-dual-judge-markdown-review-nowrap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ootbt-dual-judge-markdown-review
Source: https://github.com/nowrap/ootbt-skills/tree/main/skills/ootbt-dual-judge-markdown-review
Command: npx skills add https://github.com/nowrap/ootbt-skills --skill ootbt-dual-judge-markdown-review-nowrap

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Single-reviewer AI checks of plans, implementation reports, and factual Markdown documents tend to confirm rather than challenge claims, and a single model's verdict is hard to trust. This Skill runs two fresh, mutually blind judge processes against a byte-frozen snapshot of the document and the repository, so every load-bearing claim is tested adversarially against reproducible ground truth instead of model opinion. ## Core Features & Use Cases - Dual blind judges: Judge A runs the latest Astra model resolved live from the Codex catalog with max reasoning effort; Judge B runs Claude via the moving fable alias. Neither sees the other's prompt, output, or report. - Two modes: challenge-only publishes both independent reviews preserving dissent; consolidate adds an anonymous evidence evaluator, a frozen revision contract, and a separate reviser whose changes are mechanically replayed and validated. - Fail-closed validation: Reports are checked for required sections, claim matrices, evidence status, secret leaks, and internal path leaks before publication; failed checks abort rather than degrade silently. - Use Case: Challenge a migration plan or an implementation report by having both judges verify claims like "implemented", "merged", or "tested" against fixed repository commits, with every verdict backed by path:line evidence. ## Quick Start Ask the agent to challenge a specific Markdown plan or implementation document with the dual-judge review, for example by requesting two independent reviews of the file placed next to it as Judge A and Judge B reports.

Frequently Asked Questions about ootbt-dual-judge-markdown-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get two independent AI reviews of a Markdown plan?

Point the skill at the Markdown file and request a dual-judge challenge. It freezes a byte-identical snapshot with its SHA-256, runs Judge A (latest Astra via Codex) and Judge B (Claude fable alias) in isolated processes, and publishes both validated reports next to the source file.

What is the difference between challenge-only and consolidate mode?

Challenge-only publishes the two independent judge reports and preserves any dissent without synthesis. Consolidate adds an anonymous evidence evaluator that adjudicates each claim against ground truth, freezes a revision contract, and lets a separate reviser produce a new document version validated by exact-replacement replay.

Which tools and CLIs does the dual-judge review require?

The workflow requires installed and authenticated Codex and Claude Code CLIs, plus Python and bash for the runner and validation scripts. On Windows it prefers a WSL path with native Linux Node and Codex when the capability check passes, otherwise it uses native Windows Codex.

Does the skill decide disputes by model majority?

No. The core principle is that evidence beats model majority. The optional evaluator is not a third vote; every decision must bind a claim to reproduced ground truth, and undecidable dissent remains marked as UNKNOWN or contradiction.

What happens when a judge run or preflight check fails?

The workflow is fail-closed: a failed Astra preflight, sandbox error, or invalid report aborts the run without silent fallback to a weaker model or bypassed sandbox. Failed attempts stay archived in the handoff directory and retries start as fresh processes.

When should I not use the dual-judge markdown review?

Skip it when a single review is sufficient, when you want an immediate synthesized answer rather than preserved dissent, or when a full thesis-judge-evaluator pipeline is required. It is designed for adversarial verification of Markdown artifacts, not general document editing.