research.experiment.run

Executes ablation experiment runs across cells and seeds with reproducible run directories.

Updated May 9, 2026
One-click install
npx skills add https://github.com/0h-n0/auto-research --skill research-experiment-run-0h-n0
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: research.experiment.run
Source: https://github.com/0h-n0/auto-research/tree/main/skills/research.experiment.run
Command: npx skills add https://github.com/0h-n0/auto-research --skill research-experiment-run-0h-n0

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Running LLM ablation experiments across many factor combinations and seeds is error-prone: runs get lost, configs drift, failed runs are deleted, and results become impossible to reproduce. This Skill automates Phase 6 of the auto-research workflow by executing every ablation cell with full reproducibility tracking. ## Core Features & Use Cases - Ablation Matrix Execution: Parses the Ablation Matrix from 04_EXPERIMENT_PLAN.md, generates the Cartesian product of cells, creates Hydra override configs, and runs each cell across multiple seeds. - Reproducible Run Records: Stores each run under 06_RUNS/<run_id>/ with config.yaml, metrics.json, events.jsonl, STATUS, uv.lock, and an auto-generated reproduce.sh script. - Failure Preservation & Postmortems: Keeps failed runs with STATUS=failed, saves tracebacks to error.txt, and auto-triggers lab notebook postmortem drafts. - Use Case: After your baseline passes Phase 5, run 18 ablation cells x 3 seeds (54 runs) on one or more GPUs, then get an aggregated 06_RESULTS.md draft with mean and 95% CI per factor level plus an auto-maintained INDEX.md of all runs. ## Quick Start Run the Phase 6 ablation experiments for my current research project using the plan in 04_EXPERIMENT_PLAN.md and record every run under 06_RUNS.

Frequently Asked Questions about research.experiment.run

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

FAQPage Schema
How do I run ablation experiments across multiple seeds for LLM research?▼

Define an Ablation Matrix with factors and levels in 04_EXPERIMENT_PLAN.md, then this Skill generates the Cartesian product of cells, creates Hydra override configs per cell, and runs each cell across all seeds via uv run python training commands.

How are experiment runs made reproducible?▼

Each run gets a run_id combining timestamp, git SHA, and config hash, plus a directory containing config.yaml, metrics.json, events.jsonl, a copied uv.lock, and an auto-generated reproduce.sh script that re-executes the exact run with frozen dependencies.

Can I run ablation cells in parallel on multiple GPUs?▼

Yes. Single-GPU environments run cells serially in a loop, while multi-GPU setups assign one GPU per process using CUDA_VISIBLE_DEVICES. Slurm and Ray integration are explicitly out of scope for the current iteration.

What happens when an experiment run fails?▼

Failed runs are never deleted. They are kept with STATUS=failed, the traceback is saved to error.txt, and a POSTMORTEM.md draft is auto-generated in the run directory with hypothesis candidates derived from the event log.

What is the events.jsonl schema for structured experiment logging?▼

Each line is a JSON event with required fields event, level, ts, run_id, and duration_ms. Error events must also include error_type, error_message, and error_stack, and raw prompt or output text is prohibited for privacy.

What are the limitations of this experiment runner?▼

It does not support Slurm or Ray cluster scheduling, requires a pre-existing baseline config and experiment plan from earlier phases, and rolls back to Phase 5 if five consecutive cells fail sanity range checks.