run-experiment

Orchestrate Phase 2 experiment runs and write result_{n}.md files.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/YurainSoon/research-director --skill run-experiment-yurainsoon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: run-experiment
Source: https://github.com/YurainSoon/research-director/tree/main/.claude/skills/run-experiment
Command: npx skills add https://github.com/YurainSoon/research-director --skill run-experiment-yurainsoon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Main Agent orchestration skill for Phase 2 experiment execution coordinates the entire lifecycle: it launches runs for fidelity-passed module sets, tracks progress, and writes phase_2_verification/results/result_{n}.md for analysts to interpret, while remaining backend-agnostic and ensuring runs detach safely.

Core Features & Use Cases

  • Orchestrates Launch / Finalize workflows for Phase 2 experiments.
  • Writes structured result files, plus logs and sentinel checks for completion.
  • Supports multiple backends (local, SSH, SLURM, containers) and abstracts execution details.

Quick Start

Trigger Run in Launch mode once all fidelity reports are ALL CLEAR and the spec is ready; the skill will orchestrate background execution and artifact creation.

Frequently Asked Questions about run-experiment

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

FAQPage Schema
How do I orchestrate end-to-end experiment pipelines after module fidelity checks pass?▼

Orchestrating experiment pipelines requires triggering Launch mode once all fidelity reports are ALL CLEAR. The skill then manages the full lifecycle, detaching long-running processes safely and writing structured result files for analyst interpretation.

What is the Phase 2 experiment execution lifecycle contract and how does it work?▼

The Phase 2 experiment lifecycle contract ensures runs are launched and finalized correctly using sentinel-based completion checks. It manages run and log operations while remaining backend-agnostic, detaching background execution safely.

Can I run experiment workflows on SSH or SLURM backends?▼

Yes, experiment workflows support SSH, SLURM, local, and container backends. The skill abstracts execution details and remains backend-agnostic, allowing designated workflow runners to execute across multiple environments.

How do I generate structured result files for analyst interpretation from experiment runs?▼

Generating structured result files happens automatically during the Finalize phase of experiment execution. The skill writes phase_2_verification/results/result_{n}.md files along with logs and sentinel checks upon run completion.

Do I need a designated runner available to execute experiment workflows?▼

Yes, a designated runner is required to execute experiment workflows. The skill applies to environments where modules are ready, fidelity reports are ALL CLEAR, and a runner is available to handle the workflow.

When should I not use this approach for experiment automation?▼

You should not use this approach if fidelity reports are not ALL CLEAR or if modules are not ready. It requires a designated runner and only applies when the spec is ready and the environment supports safe background process detachment.