meta-review-protocol
Skill53 starsChanged 55 days agoApache-2.0View on GitHub
Steering memo format, final report format, and pattern-identification methodology for the meta-review agent.
We split this skill into the rules it gives an agent
13 rules. About 0 are common, 10 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈10
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 23
If the task message is ambiguous, ask the supervisor for clarification before proceeding.
- Distinctive: line 72
Which scoring axes are consistently low?: If testability scores are low across the board, generation agents need guidance on experimental …
- Distinctive: line 76
Are citation quality concerns recurring?: If multiple hypotheses rely on unverifiable citations or preprints, flag this.
- Distinctive: line 96
Do certain clusters consistently underperform?: If hypotheses from cluster C-03 always lose their matches, the underlying focus area may …
- Very specific: line 124
Write the steering memo to meta/epoch-N-steering.md where N is the current epoch number:
- Distinctive: line 218
Use the final composite Elo standings as the primary ranking.
- Distinctive: line 221
Read the hypothesis JSON for the full statement, mechanism, predictions, experiments, and evidence.
- Distinctive: line 223
Read all reviews for this hypothesis across all epochs.
- Distinctive: line 224
Read all match records involving this hypothesis.
- Very specific: line 241
Check that each cited paper actually supports the claim made in the hypothesis's evidence[].note field.
- Distinctive: line 244
Important: Do not simply repeat the citations from the hypothesis file.
- Distinctive: line 259
Look across the full hypothesis portfolio for:
- Very specific: line 276
Write the final report to report/final.md:
≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Meta-Review Protocol
This skill teaches you how to synthesize individual reviews and tournament match data into two types of output: steering memos (per-epoch guidance) and final reports (end-of-run deliverables). Your role is to see the big picture that individual reviewers and judges cannot — recurring patterns, systemic weaknesses, and strategic opportunities across the full hypothesis portfolio.
Mode Selection
Your task message from the supervisor specifies which mode to operate in:
- "steering memo" or "steering" → produce a per-epoch steering memo.
- "final report" or "final" → produce the end-of-run final report.
If the task message is ambiguous, ask the supervisor for clarification before proceeding.
Mode 1: Steering Memo (Per-Epoch)
Purpose
Guide the next epoch's generation, review, and evolution agents by identifying recurring patterns in the current epoch's reviews and tournament matches. The steering memo is injected by the supervisor into subsequent workers' task messages — it must be concrete and actionable.
Input
- All reviews from the current epoch — read every
reviews/H-XXXX.R-NN.jsonfile where the review'sepochfield matches the current epoch. - Match records from the current epoch — read every
matches/M-NNNN.jsonfile where the match'sepochfield matches the current epoch. - Match transcripts — if a match record has a
transcript_pathfield, read the transcript. Tier 2 multi-turn debate transcripts are especially valuable because they expose the reasoning behind losses. - Current standings — read
ratings/epoch-N.jsonfor the current epoch to understand relative hypothesis strength. - Prior steering memos (if any) — read
meta/epoch-*-steering.mdfrom previous epochs to build on past guidance and track whether prior recommendations were addressed.
Analysis Methodology
The goal is to identify recurring patterns, not just list individual findings. A useful steering memo says "Reviewers repeatedly flag missing dosing rationale across hypotheses in the neuroinflammation cluster" — not "H-0003 got a low testability score."
Step 1: Aggregate Review Findings
For each review, extract:
- The four axis scores (correctness, novelty, testability, safety)
- Key criticisms
- Verified vs. unverified citations
- Contradicting evidence found
Then look for cross-cutting patterns:
- Which criticisms appear in multiple reviews? Group criticisms by theme (e.g., "weak experimental controls", "unsupported mechanistic step", "low novelty — prior art exists").
- Which scoring axes are consistently low? If testability scores are low across the board, generation agents need guidance on experimental design.
- Which focus areas produce stronger hypotheses? Compare score distributions across focus areas / clusters.
- Are citation quality concerns recurring? If multiple hypotheses rely on unverifiable citations or preprints, flag this.
Step 2: Analyze Tournament Losses
For each match, extract:
- Winner and loser
- Victory margin (decisive vs. narrow)
- Criterion scores for each contestant
- The judge's rationale
- Transcript content (for Tier 2 debates)
Then identify loss patterns:
- Why do hypotheses lose? Common loss reasons include:
- Weaker experimental feasibility
- Less specific predictions
- Thinner evidence base
- Lower novelty (too similar to existing work)
- Mechanistic gaps identified during debate
- Do certain clusters consistently underperform? If hypotheses from cluster C-03 always lose their matches, the underlying focus area may need reframing.
- Are narrow losses revealing? A hypothesis that narrowly loses may need only a small improvement (e.g., one additional piece of evidence, a more specific prediction) to become competitive.
Step 3: Synthesize Into Guidance
Transform patterns into concrete, actionable guidance:
- Guidance for generation — what kinds of hypotheses to produce (or avoid) in the next epoch. Reference specific patterns: "Focus area X is underexplored — only 2 hypotheses from this area, both scored well. Consider generating more hypotheses here." Or: "Avoid hypotheses that rely solely on correlational evidence from animal models without a proposed causal mechanism."
- Guidance for review — calibration adjustments for reviewers. "Reviewers may be too lenient on testability — several hypotheses scored 4/5 despite lacking specific experimental readouts. Apply the testability anchors more strictly." Or: "Contradiction searches are effective — 3 reviews found contradicting evidence that lowered correctness scores. Continue this practice."
- Guidance for evolution — which hypotheses to target with which operators. "H-0007 lost its match on testability — consider applying the simplify operator to reduce experimental complexity." Or: "Hypotheses in cluster C-01 share a common mechanistic gap at step 3 — a ground operator targeting this step could strengthen the entire cluster."
Output Format
Write the steering memo to meta/epoch-N-steering.md where N is the current
epoch number:
# Epoch N Steering Memo
## Summary Statistics
- Hypotheses reviewed: [count]
- Matches played: [count]
- Mean review scores: correctness [X.X], novelty [X.X], testability [X.X], safety [X.X]
- Hypotheses quarantined: [count]
## Recurring Patterns
### Pattern 1: [Short descriptive title]
- **Observation:** [What you found across multiple reviews/matches]
- **Evidence:** [Specific review IDs, match IDs, and excerpts]
- **Frequency:** [How many hypotheses/reviews exhibit this pattern]
### Pattern 2: [Short descriptive title]
...
## Guidance for Generation
- [Specific, actionable guidance based on identified patterns]
- [Reference the patterns above by name]
- [Include both "do more of" and "avoid" recommendations]
## Guidance for Review
- [Calibration adjustments for scoring axes]
- [Areas to probe deeper in the next epoch]
- [Effective practices to continue]
## Guidance for Evolution
- [Which hypotheses are strong candidates for which operators]
- [Specific weaknesses that evolution operators can address]
- [Cross-cluster combination opportunities]
## Priority Focus Areas
- [Underexplored areas to prioritize]
- [Saturated areas to deprioritize]
- [Areas where quality is strong vs. weak]
## Comparison to Prior Steering (if applicable)
- [Whether previous recommendations were addressed]
- [Patterns that persist from prior epochs]
- [New patterns that emerged this epoch]Quality Bar
A good steering memo:
- Identifies at least 2 recurring patterns with evidence from multiple reviews or matches
- Provides actionable guidance, not vague advice ("improve hypotheses" is useless; "add dose-response predictions to hypotheses proposing drug interventions" is actionable)
- Distinguishes between patterns that affect many hypotheses and issues that affect only one
- Connects tournament loss patterns to specific improvable weaknesses
- Is short enough to be read and acted upon by generation and review agents (aim for 1–3 pages, not 10)
Mode 2: Final Report
Purpose
Produce a comprehensive research report when the system converges or the exploration budget is exhausted. This is the primary deliverable of the OASE Hypex subgraph — it should be well-structured, evidence-based, and actionable for a research team planning follow-up experiments.
Input
- All hypotheses — read every
hypotheses/H-XXXX.jsonfile (all epochs). - All reviews — read every
reviews/H-XXXX.R-NN.jsonfile (all epochs). - All match records — read every
matches/M-NNNN.jsonfile (all epochs). - All ratings files — read every
ratings/epoch-N.jsonfile to compute Elo trajectories. - Final Elo standings — use
elo standings --run-dir <run-dir> --composite --explain --format jsonto get the definitive rankings. Each entry includeselo,elo_composite,composite_delta,composite_weights, andcomponents. - Cluster data — read
proximity/clusters.jsonfor cluster assignments and labels. - Steering memos — read all
meta/epoch-*-steering.mdfiles for the system's learning trajectory. - Run configuration — read
run.yamlfor the original research goal, epoch count, budget configuration.
Analysis Methodology
Step 1: Establish Rankings
Use the final composite Elo standings as the primary ranking. For each hypothesis in the top 10:
- Read the hypothesis JSON for the full statement, mechanism, predictions, experiments, and evidence.
- Read all reviews for this hypothesis across all epochs.
- Read all match records involving this hypothesis.
- Compute the Elo trajectory: extract the hypothesis's Elo rating from each epoch's ratings file to show how its ranking evolved over time.
Step 2: Verify Evidence (Top 10 Only)
For each hypothesis in the top 10, independently verify its key evidence claims using OASE's citation and literature commands:
# Verify the complete Hypex evidence array
oase cite verify <run-dir>/hypotheses/H-XXXX.json --out raw/citations
# Resolve any PMID, arXiv identifier, or DOI into an OASE literature artifact
oase litref resolve <identifier> --jsonCheck that each cited paper actually supports the claim made in the hypothesis's
evidence[].note field. Note any discrepancies in the report.
Important: Do not simply repeat the citations from the hypothesis file. You must independently verify them. If a citation cannot be verified (fetch fails or the paper does not support the claimed finding), note this explicitly in the report.
Step 3: Synthesize Review History
For each top-10 hypothesis, produce a review digest:
- What were the strongest criticisms across all reviews?
- Were criticisms addressed in subsequent versions (via evolution)?
- What is the consensus assessment across reviewers?
- Were there disagreements between reviewers?
Step 4: Identify Contradictions
Look across the full hypothesis portfolio for:
- Hypotheses that propose contradictory mechanisms for the same phenomenon
- Evidence that supports one hypothesis but undermines another
- Unresolved debates that tournament matches did not settle definitively
Step 5: Build Experimental Roadmap
From the top-10 hypotheses' experiment fields, produce a prioritized experimental plan:
- Group experiments by required resources and methodology
- Identify experiments that could test multiple hypotheses simultaneously
- Estimate difficulty tiers (easy / medium / hard)
- Suggest a phased approach: quick-win experiments first, high-investment experiments after initial validation
Output Format
Write the final report to report/final.md:
# Hypothesis-Explorer Final Report
## Research Goal
[Original research question from run.yaml]
## Executive Summary
[2–3 paragraph overview of key findings, top hypotheses, and recommended
next steps. Written for a PI or research director who needs the bottom line.]
## Methodology
- **Epochs run:** [N]
- **Total hypotheses generated:** [N]
- **Hypotheses after dedup:** [N]
- **Total reviews conducted:** [N]
- **Tournament matches played:** [N]
- **Final ranking method:** Elo tournament (with composite Elo anchoring)
- **Convergence:** [Whether top-5 stabilized, or budget was exhausted]
## Top Hypotheses (Ranked by Composite Elo)
| Rank | ID | Title | Composite Elo | Elo | Focus Area / Key Mechanism |
|------|-----|-------|---------------|-----|----------------------------|
| 1 | ... | ... | ... | ... | ... |
| 2 | ... | ... | ... | ... | ... |
...
### 1. [Title] (H-XXXX, Composite Elo: NNNN, Elo: NNNN)
**Statement:** [One-paragraph falsifiable claim]
**Mechanism:** [Summary of the proposed causal mechanism]
**Key Evidence:**
- [lit_id]: [What this paper shows and how it supports the hypothesis] ✓ verified
- [lit_id]: [What this paper shows] ✓ verified
- [lit_id]: [What this paper shows] ⚠ could not verify / does not support claim
**Review Digest:**
- Mean scores: correctness [X]/5, novelty [X]/5, testability [X]/5, safety [X]/5
- [Number] reviews across [number] epochs
- Key strengths: [from reviews]
- Persistent criticisms: [from reviews]
**Elo Trajectory:**
| Epoch | Elo | Matches | Wins | Rank |
|-------|-----|---------|------|------|
| 0 | ... | ... | ... | ... |
| 1 | ... | ... | ... | ... |
| ... | ... | ... | ... | ... |
**Proposed Experiments:**
1. [Design] — Readout: [readout] — Difficulty: [easy/med/hard]
2. [Design] — Readout: [readout] — Difficulty: [easy/med/hard]
---
### 2. [Title] (H-XXXX, Composite Elo: NNNN, Elo: NNNN)
[Repeat structure for top 10]
---
## Unresolved Contradictions
### Contradiction 1: [Short title]
- **Hypotheses involved:** H-XXXX vs. H-YYYY
- **Nature of contradiction:** [What they disagree about]
- **Evidence for each side:** [Brief summary]
- **Suggested resolution:** [What experiment or analysis could resolve this]
---
## Experimental Roadmap
### Phase 1: Quick Wins (Easy, 1–3 months)
- [Experiment from H-XXXX]: [brief description]
- [Experiment from H-YYYY]: [brief description]
### Phase 2: Core Validation (Medium, 3–12 months)
- [Experiment from H-XXXX]: [brief description]
### Phase 3: Deep Investigation (Hard, 12+ months)
- [Experiment from H-XXXX]: [brief description]
### Cross-Cutting Experiments
- [Experiments that test multiple hypotheses simultaneously]
---
## Cluster Analysis
- **C-01: [Label]** — [N] hypotheses, top-ranked: H-XXXX (Elo NNNN)
- **C-02: [Label]** — [N] hypotheses, top-ranked: H-XXXX (Elo NNNN)
...
## System Learning Trajectory
[Brief summary of how steering memos evolved across epochs — what the system
learned, what guidance was most effective, what patterns persisted]
## Appendix: Full Hypothesis Index
| Rank | ID | Title | Composite Elo | Elo | Cluster | Status |
|------|-----|-------|---------------|-----|---------|--------|
| 1 | ... | ... | ... | ... | ... | ... |
| 2 | ... | ... | ... | ... | ... | ... |
...Quality Bar
A good final report:
- Ranks hypotheses by the standings the tool emits, not by the author's subjective preference
- Includes Elo trajectories showing how rankings evolved across epochs
- Independently verifies citations for all top-10 hypotheses using OASE citation tooling
- Distinguishes between verified and unverified claims with clear markers
- Identifies unresolved contradictions between hypotheses, not just within them
- Provides an experimental roadmap that is prioritized and phased
- Is written for a scientist who will actually plan experiments, not for an agent or an automated pipeline
- Includes methodology notes so the exploration process is transparent
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 1
- terravic/pde-agent-plugin★ 098% same
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository82 other files it gives its agents.
- applications/open-agentic-science-engine/templates/admet-dmpk-scientist/agents.mdAGENTS.md
- applications/open-agentic-science-engine/templates/bootstrapper/agents.mdAGENTS.md
- applications/open-agentic-science-engine/templates/computational-biologist/agents.mdAGENTS.md
- applications/open-agentic-science-engine/templates/computational-chemist/agents.mdAGENTS.md
- applications/open-agentic-science-engine/templates/experimental-biologist/agents.mdAGENTS.md
- applications/open-agentic-science-engine/templates/finding-validator/agents.mdAGENTS.md
- applications/open-agentic-science-engine/templates/head-of-discovery/agents.mdAGENTS.md
- applications/open-agentic-science-engine/templates/hypex-evolution/agents.mdAGENTS.md
- applications/open-agentic-science-engine/templates/hypex-generation/agents.mdAGENTS.md
- applications/open-agentic-science-engine/templates/hypex-meta-review/agents.mdAGENTS.md
- applications/open-agentic-science-engine/templates/hypex-proximity/agents.mdAGENTS.md
- applications/open-agentic-science-engine/templates/hypex-reflection/agents.mdAGENTS.md
- applications/open-agentic-science-engine/templates/hypex-supervisor/agents.mdAGENTS.md
- applications/open-agentic-science-engine/templates/hypex-tournament/agents.mdAGENTS.md
- applications/open-agentic-science-engine/templates/medicinal-chemist/agents.mdAGENTS.md
- applications/open-agentic-science-engine/templates/preclinical-toxicologist/agents.mdAGENTS.md
- applications/open-agentic-science-engine/templates/project-curator/agents.mdAGENTS.md
- applications/open-agentic-science-engine/templates/regulatory-scientist/agents.mdAGENTS.md
- applications/open-agentic-science-engine/templates/research-operations-controller/agents.mdAGENTS.md
- applications/open-agentic-science-engine/templates/science-program-lead/agents.mdAGENTS.md
- applications/open-agentic-science-engine/templates/scientific-reviewer/agents.mdAGENTS.md
- applications/open-agentic-science-engine/templates/structural-biologist/agents.mdAGENTS.md
- cost-estimationSkill
- database-queriesSkill
- job-managementSkill
- job-submissionSkill
- results-analysisSkill
- storage-managementSkill
- visualizationSkill
- admet-property-predictionSkill
- artifact-conventionsSkill
- binding-mode-analysisSkill
- bioactivity-landscapeSkill
- brain-atlasSkill
- citation-resolutionSkill
- citation-verificationSkill
- competitive-differentiationSkill
- compound-identity-resolutionSkill
- compound-property-profileSkill
- debate-protocolSkill
- disease-transcriptomicsSkill
- elo-tournamentSkill
- evolution-operatorsSkill
- hypex-tool-setupSkill
- hypothesis-entrySkill
- hypothesis-run-corpusSkill
- hypothesis-schemaSkill
- in-vivo-pk-analysisSkill
- literature-searchSkill
- manufacturing-feasibilitySkill
- model-organism-phenotypeSkill
- pocket-druggabilitySkill
- preclinical-safety-assessmentSkill
- program-state-managementSkill
- protein-structure-confidenceSkill
- proximity-protocolSkill
- regulatory-variant-effectSkill
- review-rubricSkill
- run-protocolSkill
- safety-screenSkill
- The first 60 shown.
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
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.

