oracle-review-loop

Automate review loops with fixed chat threads and a 100-point rubric until PASS.

2|Updated Jul 9, 2026
One-click install
npx skills add https://github.com/koki3141/codex-global-skills --skill oracle-review-loop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oracle-review-loop
Source: https://github.com/koki3141/codex-global-skills/tree/main/oracle-review-loop
Command: npx skills add https://github.com/koki3141/codex-global-skills --skill oracle-review-loop

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires argparse, json, random, re, shutil, subprocess, time, pathlib, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates review loops with fixed chat threads, a user-approved 100-point rubric, and repeated improvement until PASS, saving time and ensuring quality in reviews.

Core Features & Use Cases

  • Automated Review Loop: Execute creator and evaluator sessions in a fixed chat thread.
  • User-Approved Rubric: Utilize a 100-point rubric that is approved by the user.
  • Repeated Improvement: Continuously improve the deliverable until it passes the review.
  • Use Case: Ideal for research plans, READMEs, design documents, and more, where a structured review process is needed.

Quick Start

Use the oracle-review-loop skill to start a review loop for your document 'document.md'.

Frequently Asked Questions about oracle-review-loop

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

FAQPage Schema
How do I automate document review loops with a scoring rubric?

Automate document review loops by running creator and evaluator sessions in a fixed chat thread using a user-approved 100-point rubric. The deliverable undergoes repeated improvement until it achieves a passing score.

What is a structured review process for quality assurance?

A structured review process for quality assurance evaluates documents against a user-approved 100-point rubric. It uses fixed chat threads to provide feedback and requires repeated improvement until the deliverable passes.

Do I need Python to run automated document review workflows?

Yes, you need Python scripts for loop management and evaluation. These scripts handle the automated review process, execute the evaluator sessions, and determine if the document meets the rubric criteria.

Can I use a custom rubric for evaluating research plans and design documents?

Yes, the review process utilizes a 100-point rubric that must be approved by the user. This rubric is applied to evaluate deliverables like research plans, READMEs, and design documents.

How does the review loop handle a document that fails evaluation?

When a document fails evaluation, the review loop executes repeated improvement cycles. The creator session updates the deliverable based on structured feedback until it passes the rubric criteria.

What are the limitations of using fixed chat threads for review automation?

The review automation relies on fixed chat threads and a 100-point rubric, meaning the process is constrained to the defined rubric criteria. It requires Python scripts and cannot dynamically adjust scoring rules mid-loop.