
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.
- Installs
- 810
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/orchestra-research/ai-research-skills --skill ara-rigor-reviewer- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads ara-rigor-reviewer automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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.
| Dimension | What it evaluates |
|---|---|
| D1. Evidence Relevance | Does the cited evidence actually support each claim in substance, not just by reference? |
| D2. Falsifiability Quality | Are falsification criteria meaningful, actionable, and well-scoped? |
| D3. Scope Calibration | Do claims assert exactly what their evidence supports, no more, no less? |
| D4. Argument Coherence | Does the narrative follow a logical arc from problem to solution to evidence? |
| D5. Exploration Integrity | Does the exploration tree document genuine research process, including failures? |
| D6. Methodological Rigor | Are 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.
PAPER.mdlogic/claims.mdlogic/experiments.mdlogic/problem.mdlogic/concepts.mdlogic/solution/architecture.md,algorithm.md,constraints.md,heuristics.mdlogic/related_work.mdtrace/exploration_tree.yamlevidence/README.md(if exists)- Spot-check 2-3 evidence files from
evidence/tables/orevidence/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_endorpivot - 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
- 1: Pervasive scope mismatch between claims and evidence
D4. Argument Coherence
- Observation → Gap derivation: Do the stated gaps follow logically from the observations? Or are they asserted without connection?
- Gap → Insight connection: Does the key insight in problem.md address the identified gaps?
- Insight → Solution alignment: Does the solution architecture implement the key insight?
- Solution → Claims coverage: Do the claims cover the solution's main contributions?
- Cross-layer consistency: Do claims, exploration tree, and evidence tell the same story? Flag contradictions.
- Narrative completeness: Are there motivating questions from problem.md that are neither answered nor explicitly deferred?
- Gap coverage: For each gap in problem.md, is there at least one claim that substantively addresses it? Flag gaps that are motivated but never resolved.
Scoring anchors:
- 5: Clear logical arc (observations → gaps → insight → solution → claims → evidence), all gaps addressed, no contradictions
- 4: Strong flow with minor logical gaps or one unaddressed gap
- 3: General flow present but some disconnects between layers
- 2: Significant misalignment between problem statement and claims, or unresolved contradictions
- 1: No coherent logical flow; layers tell different stories
D5. Exploration Integrity
- Dead-end quality: Is the
failure_modespecific enough to be actionable? ("Didn't work" is bad. "Divergence after 1000 steps due to gradient explosion" is good.) Is thelessona genuine transferable insight? - Decision rationale quality: Do rationales explain WHY the chosen path was preferred over alternatives? Are alternatives real alternatives or strawmen?
- Rebutted-branch consistency: Does any claim advocate an approach marked as dead_end or pivot in the tree? (This is a logical contradiction.)
- Exploration breadth: For the paper's main design choices, were at least 2 alternatives considered and documented?
- Honesty signal: Does the tree document genuine negative results, or does it read like a post-hoc justification? A tree with zero dead-ends or only trivial failures is suspicious.
Scoring anchors:
- 5: Rich tree with well-documented dead-ends (specific failure modes, actionable lessons), thorough decision rationale, genuine negative results
- 4: Good tree with minor gaps in dead-end documentation or decision rationale
- 3: Tree present but dead-ends lack specificity or decisions lack alternatives
- 2: Boilerplate documentation; dead-ends and decisions read as formulaic rather than authentic
- 1: Tree contradicts claims or reads entirely as post-hoc justification
D6. Methodological Rigor
- Baseline adequacy: Are the right things being compared? Are baselines recent and relevant? Flag experiments with "no baseline" for comparative claims.
- Ablation coverage: For claims involving multiple components, does at least one experiment isolate individual contributions?
- Statistical reporting: Do experiments mention variance, confidence intervals, number of runs, or statistical tests? Flag single-run results for quantitative claims.
- Metric-claim alignment: Does the metric actually measure what the claim asserts? (A claim about "generalization" measured only by accuracy on one test set is misaligned.)
- Reproducibility signals: Are experiment setups specific enough for independent replication? (Model name, dataset, hardware, hyperparameters.)
Scoring anchors:
- 5: Comprehensive baselines, proper ablations, statistical rigor, metrics precisely match claims, fully reproducible setup
- 4: Strong methodology with minor gaps (e.g., missing variance on one experiment)
- 3: Adequate but missing some baselines or statistical details
- 2: Significant gaps; missing baselines for comparative claims or no ablations
- 1: No baselines, no ablations, metrics don't match claims
Step 5: Compile Findings
Collect all issues found across the six dimensions into a single findings list. Assign each finding:
- finding_id: F01, F02, ... (sequential)
- dimension: which of D1-D6
- severity: one of:
critical— fundamental epistemic flaw; the claim or argument cannot stand as writtenmajor— significant weakness that undermines a claim or dimension scoreminor— noticeable issue that doesn't invalidate the worksuggestion— constructive improvement opportunity, not a flaw
- target_file: which ARA file
- target_entity: C{NN}, E{NN}, H{NN}, G{N}, or node ID (if applicable)
- evidence_span: verbatim substring from the ARA that triggered the finding (MUST be exact quote; omit if the finding is about an absence)
- observation: what you found (factual)
- reasoning: why it matters (analytical)
- suggestion: how to fix or improve it (constructive)
Sort findings by severity: critical first, then major, minor, suggestion.
Step 6: Compute Overall Grade
Calculate the mean of the six dimension scores. Apply the grade mapping:
| Grade | Condition |
|---|---|
| Strong Accept | mean ≥ 4.5 AND no dimension < 3 |
| Accept | mean ≥ 3.8 AND no dimension < 2 |
| Weak Accept | mean ≥ 3.0 AND no dimension < 2 |
| Weak Reject | mean ≥ 2.0 AND (mean < 3.0 OR any dimension < 2) |
| Reject | mean < 2.0 OR any dimension = 1 |
Step 7: Write Report
Write level2_report.json to the artifact root:
{
"artifact": "<name>",
"artifact_dir": "<path>",
"review_version": "3.0.0",
"prerequisite": "Level 1 passed",
"overall": {
"grade": "Accept",
"mean_score": 4.1,
"one_line_summary": "<1 sentence: what makes this ARA strong or weak>",
"strengths_summary": ["<top 2-3 strengths across all dimensions>"],
"weaknesses_summary": ["<top 2-3 weaknesses across all dimensions>"]
},
"dimensions": {
"D1_evidence_relevance": {
"score": 4,
"strengths": ["Evidence is substantively relevant for all 6 claims"],
"weaknesses": ["C02 cites a correlation study but makes a causal claim"],
"suggestions": ["Add an ablation experiment to isolate the causal mechanism for C02"]
},
"D2_falsifiability": {
"score": 4,
"strengths": ["..."],
"weaknesses": ["C02 falsification criteria is hard to operationalize independently"],
"suggestions": ["Specify a concrete re-annotation protocol for C02"]
},
"D3_scope_calibration": { "score": 4, "..." : "..." },
"D4_argument_coherence": { "score": 4, "..." : "..." },
"D5_exploration_integrity": { "score": 3, "..." : "..." },
"D6_methodological_rigor": { "score": 4, "..." : "..." }
},
"findings": [
{
"finding_id": "F01",
"dimension": "D6_methodological_rigor",
"severity": "major",
"target_file": "logic/experiments.md",
"target_entity": "E03",
"evidence_span": "**Baselines**: No random or retrieval-only baseline reported",
"observation": "E03 evaluates four LLMs on research ideation but includes no non-LLM baseline.",
"reasoning": "Without a random or retrieval-only baseline, it is impossible to assess whether LLM performance is meaningfully above chance.",
"suggestion": "Add a retrieval-only baseline (e.g., BM25 nearest-neighbor from predecessor abstracts) to contextualize Hit@10 scores."
}
],
"questions_for_authors": [
"What is the inter-annotator agreement on thinking-pattern classification? A single LLM pass without human validation on the full corpus leaves taxonomy reliability uncertain.",
"..."
],
"read_order": ["PAPER.md", "logic/claims.md", "..."]
}
Critical Rules
-
Verbatim evidence_span: Findings about content present in the ARA MUST quote an exact substring. Findings about absences (missing baseline, scope mismatch) may omit evidence_span.
-
Constructive tone: Every weakness must come with a suggestion. You are helping authors improve, not punishing them.
-
Calibrated scoring: Most competent ARAs should land in the 3-4 range. A score of 5 means genuinely excellent, not just "no problems found." A score of 1 means fundamental problems, not just "could be better."
-
No false grounding: Support must flow through Proof → experiments.md → evidence/. Agreement in prose (problem.md, architecture.md) does not substitute for experimental evidence.
-
Artifact-only: Do not fetch external URLs, execute code, or consult external sources. Take the ARA's reported evidence at face value.
-
Balanced review: Actively look for strengths, not just weaknesses. A review that only lists problems is not useful.
-
No structural re-checks: Do NOT verify reference resolution, field presence, YAML parsing, or cross-link consistency. Level 1 has already validated all of this. Focus entirely on whether the content is epistemically sound.
Reference
See references/review-dimensions.md for scoring anchor details and check inventories per dimension.
FAQ
What does the ara-rigor-reviewer skill do?
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.
How do I install ara-rigor-reviewer?
Run npx skills add https://github.com/orchestra-research/ai-research-skills --skill ara-rigor-reviewer in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/ara-rigor-reviewer/ (personal) or .claude/skills/ara-rigor-reviewer/ (project).
Which AI agents can use ara-rigor-reviewer?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is ara-rigor-reviewer safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains ara-rigor-reviewer?
It is published by orchestra-research in orchestra-research/ai-research-skills. It has 810 recorded installs.
More from orchestra-research/ai-research-skills
ml-paper-writing
orchestra-research/ai-research-skills
Write publication-ready ML/AI papers for NeurIPS, ICML, ICLR, ACL, AAAI, COLM. Use when drafting papers from research repos, structuring arguments, verifying citations, or preparing camera-ready submissions. For systems venues (OSDI, NSDI, ASPLOS, SOSP), use systems-paper-writing instead.
brainstorming-research-ideas
orchestra-research/ai-research-skills
Guides researchers through structured ideation frameworks to discover high-impact research directions. Use when exploring new problem spaces, pivoting between projects, or seeking novel angles on existing work.
academic-plotting
orchestra-research/ai-research-skills
Generates publication-quality figures for ML papers from research context. Given a paper section or description, extracts system components and relationships to generate architecture diagrams via Gemini. Given experiment results or data, auto-selects chart type and generates data-driven figures via matplotlib/seaborn. Use when creating any figure for a conference paper.
creative-thinking-for-research
orchestra-research/ai-research-skills
Applies cognitive science frameworks for creative thinking to CS and AI research ideation. Use when seeking genuinely novel research directions by leveraging combinatorial creativity, analogical reasoning, constraint manipulation, and other empirically grounded creative strategies.
mlflow
orchestra-research/ai-research-skills
Track ML experiments, manage model registry with versioning, deploy models to production, and reproduce experiments with MLflow - framework-agnostic ML lifecycle platform
serving-llms-vllm
orchestra-research/ai-research-skills
Serves LLMs with high throughput using vLLM's PagedAttention and continuous batching. Use when deploying production LLM APIs, optimizing inference latency/throughput, or serving models with limited GPU memory. Supports OpenAI-compatible endpoints, quantization (GPTQ/AWQ/FP8), and tensor parallelism.
Popular productivity & automation skills
agent-browser
vercel-labs/agent-browser
Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.
lark-doc
open.feishu.cn
飞书云文档(Docx / Wiki)内容操作:读取、创建、编辑文档,插入或下载图片附件,以及操作思维笔记。用户提供文档 URL/token(包括 doubao.com 的 /docx/、/wiki/)时使用;按 URL 路径/token 而非域名路由;/page/ 是妙搭应用,非飞书云文档。文档内嵌资源按读取参考中的统一规则分流。独立评论操作走 lark-drive;随正文读取评论使用 docs +fetch。表格或 Base 内部数据操作不在本 skill。
lark-base
open.feishu.cn
飞书多维表格(Base)操作:建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、应用模式(BaseApp/AppMode 页面与组件)、Workspace 目录、workflow、角色权限、模板中心(多维表格模板分类/列表/搜索);遇到 Base/多维表格/bitable、BaseApp/AppMode、/base/ 或 /app/ 链接时使用。BaseApp 不走 lark-apps;文件导入/导出转 lark-drive,认证/授权转 lark-shared。
lark-drive
open.feishu.cn
飞书云空间(云盘/云存储):管理 Drive 文件和文件夹,包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、查询权限设置、评论/权限/订阅、标题、版本、飞书文档密级标签(secure labels)和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题,或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sheet/bitable/slides 时使用;doubao.com 云空间 URL/token 也按资源路径和 token 路由,不回退 WebFetch。不负责:文档内容编辑(走 lark-doc)、表格/Base 表内数据操作(走 lark-sheets/lark-base)、知识空间节点/成员管理(走 lark-wiki)、原生 Markdown 文件读写/patch/diff(走 lark-markdown)。
lark-shared
open.feishu.cn
Use for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handling notice JSON.
lark-im
open.feishu.cn
飞书即时通讯:收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片(Interactive Card)、监听卡片按钮回调(card.action.trigger)。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员、搜索群、创建群聊或话题群、管理标记数据、管理 Feed 置顶(添加/移除/查询置顶会话)、管理标签数据、处理卡片回调时使用。