experiment-run

Standardizes experiment runs with configurable parameters and structured output formats.

7|1|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/gyy0592/claude-config --skill experiment-run
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: experiment-run
Source: https://github.com/gyy0592/claude-config/tree/main/skills/experiment-run
Command: npx skills add https://github.com/gyy0592/claude-config --skill experiment-run

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Ensures every computational experiment is launched, recorded, and validated so results are reproducible, discoverable, and auditable months later. It prevents lost metrics, hidden hyperparameters, and irreproducible outputs by enforcing config-driven runs, structured output directories, and immediate recording.

Core Features & Use Cases

  • Config-first runs: All runtime parameters live in a single config file so scripts have no hardcoded magic values.
  • Recording negotiation and formats: Interactive negotiation of scalar, intermediate, and artifact fields with exact scalars.csv and events.jsonl schemas.
  • Robust run lifecycle: Pre-flight confirmation, code snapshot, run_manifest, Slurm/local job generation, incremental recording with flushes, and post-run validation producing run_checks.json.
  • Use cases: Training jobs on GPU clusters with Slurm, local long-running data processing, repeated evaluation experiments with per-sample logging, and any workflow where checkpoints and metrics must be preserved.

Quick Start

Prepare a config, negotiate what metrics and per-item fields to record, confirm the pre-flight summary, then create the exp/ directory, snapshot the code, and generate and submit the job.

Frequently Asked Questions about experiment-run

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

FAQPage Schema
How do I make machine learning experiments reproducible on a Slurm cluster?

To make experiments reproducible on a Slurm cluster, enforce config-driven parameters, generate Slurm job scripts, snapshot code, and record structured metrics in scalars.csv and events.jsonl formats for consistent auditing.

What is the best way to record training metrics and hyperparameters for reproducibility?

The best way to record training metrics for reproducibility is enforcing config-first runs and capturing outputs in structured exp/ directories with exact scalars.csv and events.jsonl schemas to prevent lost metrics and hidden hyperparameters.

How do I validate experiment outputs after a long-running data processing job?

To validate experiment outputs after data processing, run a post-run validation step that checks the structured exp/ directory and produces a run_checks.json file, ensuring all recorded metrics and artifacts match the initial config.

Can I use config-driven experiment tracking for local data processing workflows?

Yes, config-driven experiment tracking works for local data processing workflows by generating local job scripts, performing pre-flight confirmation, and enforcing structured output directories to preserve checkpoints and metrics.

Why do I need pre-flight confirmation and code snapshots before submitting a training job?

Pre-flight confirmation and code snapshots are needed before submitting a training job to capture the exact runtime state and config parameters, preventing irreproducible outputs and ensuring the run_manifest accurately reflects the executed code.

Does this experiment recording approach support per-sample logging during evaluation?

Yes, this experiment recording approach supports per-sample logging during repeated evaluation experiments by negotiating intermediate and artifact fields interactively, capturing them incrementally with flushes into structured events.jsonl files.