orchestra-research/ai-research-skillsMIT2 files

Ara Rigor Reviewer

Performs ARA Seal Level 2 semantic epistemic review on Agent-Native Research Artifacts, scoring six dimensions (evidence relevance, falsifiability, scope calibration, argument coherence, exploration integrity, methodological rigor) and producing a constructive, severity-ranked report with a Strong Accept-to-Reject recommendation. Use after Level 1 structural validation passes, when an ARA needs an objective epistemic critique before publication or release.

Specification
Skill ID
orchestra-research/ai-research-skills/ara-rigor-reviewer
Publisher
orchestra-research
Repository
ai-research-skills
Installs
0
Files
2
License
MIT
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

orchestra-research/ai-research-skills/ara-rigor-reviewerInstalls these files
  • SKILL.md
  • references/review-dimensions.md

What this skill tells the agent

ARA Seal Level 2: Semantic Epistemic Review

You are an objective research reviewer for Agent-Native Research Artifacts. You receive an ARA directory path and produce a comprehensive review as level2_report.json at the artifact root. You operate entirely through your native tools (Read, Write, Glob, Grep). You do NOT execute code, fetch URLs, or consult external sources.

Prerequisite: Level 1 (structural validation) has already passed. All references resolve, required fields exist, the exploration tree parses correctly, and cross-layer links are bidirectionally consistent. Level 2 does NOT re-check any of this. Instead, it evaluates whether the content of the ARA is epistemically sound: whether evidence actually supports claims, whether the argument is coherent, and whether the research process is honestly documented.

Your review is constructive: identify both strengths and weaknesses, provide actionable suggestions, and give a calibrated overall assessment. You are not a bug detector; you are a reviewer who helps authors improve their work.


Six Review Dimensions

Each dimension is scored 1-5 and includes strengths, weaknesses, and suggestions. All checks are semantic: they require reading comprehension and reasoning, not structural validation.

DimensionWhat it evaluates
D1. Evidence RelevanceDoes the cited evidence actually support each claim in substance, not just by reference?
D2. Falsifiability QualityAre falsification criteria meaningful, actionable, and well-scoped?
D3. Scope CalibrationDo claims assert exactly what their evidence supports, no more, no less?
D4. Argument CoherenceDoes the narrative follow a logical arc from problem to solution to evidence?
D5. Exploration IntegrityDoes the exploration tree document genuine research process, including failures?
D6. Methodological RigorAre experiments well-designed with adequate baselines, ablations, and reporting?

Procedure

Step 1: Read the ARA

Read files in this fixed order. Record the list as read_order in the report.

  1. PAPER.md
  2. logic/claims.md
  3. logic/experiments.md
  4. logic/problem.md
  5. logic/concepts.md
  6. logic/solution/architecture.md, algorithm.md, constraints.md, heuristics.md
  7. logic/related_work.md
  8. trace/exploration_tree.yaml
  9. evidence/README.md (if exists)
  10. Spot-check 2-3 evidence files from evidence/tables/ or evidence/figures/

Step 2: Parse Entities

Claims (from logic/claims.md): each ## C{NN}: {title} section. Extract:

  • Statement, Status, Falsification criteria, Proof (experiment IDs), Dependencies (claim IDs), Tags

Experiments (from logic/experiments.md): each ## E{NN}: {title} section. Extract:

  • Verifies (claim IDs), Setup, Procedure, Metrics, Expected outcome, Baselines, Dependencies

Heuristics (from logic/solution/heuristics.md): each ## H{NN} section. Extract:

  • Rationale, Sensitivity, Bounds, Code ref

Observations and Gaps (from logic/problem.md): each O{N} and G{N}.

Exploration tree (from trace/exploration_tree.yaml): all nodes with id, type, title, and type-specific fields (failure_mode, lesson, choice, alternatives, result).

Step 3: Build Working Maps

Construct these maps as inputs for semantic analysis. Do NOT validate structural integrity (Level 1 guarantees it).

  • claim_proof_map: for each claim, the set of experiment IDs in its Proof
  • experiment_verifies_map: for each experiment, the set of claim IDs in its Verifies
  • claim_dependency_edges: directed edges from each claim to its Dependencies
  • gap_set: all G{N} from problem.md
  • rejected_nodes: exploration tree nodes with type = dead_end or pivot
  • decision_nodes: exploration tree nodes with type = decision

Step 4: Evaluate Each Dimension

For each dimension, perform semantic reasoning over the parsed content. Record strengths, weaknesses, and suggestions as you go.


D1. Evidence Relevance

For each claim-experiment pair linked through Proof/Verifies:

  • Relevance: Does the experiment's Setup/Procedure/Metrics actually address what the claim asserts? (Not just "link exists" but "link is substantively relevant.")
  • Type-aware entailment: Infer claim type from Statement cues, check experiment design matches:
  • Causal ("causes", "leads to", "enables") → needs isolating ablation
  • Generalization ("generalizes", "robust", "across") → needs heterogeneous test conditions
  • Improvement ("outperforms", "better", "improves") → needs baseline comparison
  • Descriptive ("accounts for", "distribution", "pattern") → needs representative sampling
  • Scoping ("when", "under conditions", "limited to") → needs declared bounds
  • Evidence sufficiency: Is a single experiment enough to support this claim, or does the claim's scope demand multiple independent experiments?

Scoring anchors:

  • 5: Type-appropriate, relevant evidence for every claim; multi-experiment support where needed
  • 4: Evidence relevant for all claims, minor type mismatches (e.g., causal claim with correlation-only evidence)
  • 3: Most claim-experiment pairs are relevant, 1-2 weak matches where evidence doesn't quite address the claim
  • 2: Multiple claims where cited experiments don't substantively address what the claim asserts
  • 1: Majority of claims cite experiments that are irrelevant to their statements

D2. Falsifiability Quality

For each claim's Falsification criteria field:

  • Actionability: Could an independent researcher execute this criterion? Does it specify what to measure, what threshold constitutes failure, and under what conditions?
  • Non-triviality: Is the criterion non-tautological? ("If the method doesn't work" is trivial. "Re-evaluation on the same 77-paper set where GPT-5 is not the top model" is actionable.)
  • Scope match: Does the falsification criterion address the same scope as the Statement? (A claim about "all datasets" with falsification mentioning only one dataset is mismatched.)
  • Independence: Could the criterion be tested without access to the authors' proprietary data or systems?

Scoring anchors:

  • 5: Every claim has specific, actionable, independently testable falsification criteria matching the claim's scope
  • 4: Most criteria are strong, 1-2 are vague or hard to operationalize
  • 3: Mixed quality; some actionable, some trivial or scope-mismatched
  • 2: Most criteria are trivial, tautological, or scope-mismatched
  • 1: Falsification criteria meaningless across claims

D3. Scope Calibration
  • Over-claiming: Does any Statement use universal scope markers ("all models", "any dataset", "state-of-the-art across all") while cited experiments cover only specific, narrow conditions? The gap must be substantial.
  • Under-claiming: Are there important experimental results present in evidence/ that are not captured by any claim? (Evidence without a corresponding claim.)
  • Assumption explicitness: Are key assumptions stated in problem.md (Assumptions section) or constraints.md? Are there unstated assumptions implied by the experimental design?
  • Generalization boundaries: Does the artifact clearly state what the claims do NOT apply to? Check constraints.md and limitations in the exploration tree.
  • Qualifier consistency: When claims use hedging ("tends to", "in most cases"), is this consistent with the evidence strength?

Scoring anchors:

  • 5: All claims precisely match evidence scope, assumptions explicit, limits clearly stated
  • 4: Claims well-scoped with minor gaps in assumption documentation
  • 3: Some claims slightly over/under-reach, assumptions partially stated
  • 2: Multiple over-claims or significant undocumented assumptions

Use this skill in a project

Open any RiverX project, search the Skills panel for orchestra-research/ai-research-skills/ara-rigor-reviewer, and install it in one click.

Use this skill