gaia-submission

Runs GAIA benchmarks and packages signed HAL-compatible leaderboard submissions.

70.1k|8.4k|Updated Jun 2, 2025
One-click install
npx skills add https://github.com/ruvnet/claude-flow --skill gaia-submission
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gaia-submission
Source: https://github.com/ruvnet/claude-flow/tree/main/plugins/ruflo-workflows/skills/gaia-submission
Command: npx skills add https://github.com/ruvnet/claude-flow --skill gaia-submission

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Submitting benchmark results to the Princeton GAIA leaderboard requires environment validation, cost estimation, benchmark execution, integrity auditing, and signed packaging — a multi-step process that is easy to get wrong. This Skill walks through the entire flow from a clean environment to a signed, HAL-compatible submission package.

Core Features & Use Cases

  • End-to-End Benchmark Workflow: Validates prerequisites (API keys, Node.js, CLI build), estimates run cost, executes the GAIA benchmark, and reports progress every 5 questions.
  • Integrity-Gated Submission Packaging: Runs a deterministic exploit audit (ADR-167) before signing, refusing to build the leaderboard package on CRITICAL findings such as answer leakage or grader monkey-patching.
  • Signed HAL-Compatible Output: Produces results.jsonl, trajectories.jsonl, metadata.json, an audit report, and an Ed25519-signed witness manifest ready for leaderboard upload.
  • Use Case: A researcher wants to publish their agent's GAIA Level 1 score. The Skill confirms the environment, estimates the ~$5 run cost, executes 53 questions, audits the run for exploits, and emits a signed submission directory comparable against the leaderboard top-10.

Quick Start

Ask Claude to run the GAIA benchmark at level 1 with the default model and package the results into a signed leaderboard submission.

Frequently Asked Questions about gaia-submission

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

FAQPage Schema
How do I submit GAIA benchmark results to the HAL leaderboard?

Run the benchmark with /gaia run, then package results using /gaia submit with your results file. This generates a HAL-compatible directory containing results.jsonl, trajectories.jsonl, metadata, an audit report, and an Ed25519-signed manifest ready for upload.

What prerequisites are needed to run a GAIA benchmark?

You need an ANTHROPIC_API_KEY, an HF_TOKEN for dataset access, Node.js 20 or later, and a built claude-flow CLI. The /gaia validate command runs all pre-flight checks before starting.

How much does a GAIA benchmark run cost?

Cost depends on level, question limit, models, and self-consistency voting. Use /gaia cost with your configuration to get an estimate; the workflow prompts for confirmation if the projected cost exceeds $5.

Why does the GAIA submission audit block my package?

The ADR-167 integrity gate refuses to build the package on CRITICAL findings such as answer leakage, no-work passes, oracle leakage, grader monkey-patching, or dynamic eval of task content. Inspect audit-report.json and fix the finding rather than using --allow-dirty.

Can this workflow be used for benchmarks other than GAIA?

Yes, the phase structure (validate, estimate, run, package, compare, learn) is benchmark-agnostic. SWE-bench, WebArena, and HumanEval can follow the same flow with only the run and package phases changing.