Run Experiment

Orchestrate SLURM fine-tuning jobs with torchtune and evaluate with inspect-ai.

16|1|Updated Apr 4, 2025
One-click install
npx skills add https://github.com/niznik-dev/cruijff_kit --skill run-experiment
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Run Experiment
Source: https://github.com/niznik-dev/cruijff_kit/tree/main/.claude/skills/run-experiment
Command: npx skills add https://github.com/niznik-dev/cruijff_kit --skill run-experiment

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually submitting multiple SLURM jobs and constantly monitoring their status is tedious and inefficient. This Skill automates the submission of all fine-tuning jobs and provides continuous, automatic monitoring, freeing you from constant oversight and letting AI handle the heavy lifting.

Core Features & Use Cases

  • Automated Job Submission: Submits all finetune.slurm jobs with appropriate staggering to prevent cache issues.
  • Real-time Status Monitoring: Polls SLURM (squeue, sacct) to track job states (PENDING, RUNNING, COMPLETED, FAILED) for all your runs.
  • Automatic Status Updates: Keeps your experiment_summary.md updated with job IDs, start/completion times, and current status for each run.
  • Use Case: After scaffolding an experiment with 10 fine-tuning runs, use this skill to submit all jobs to the cluster and then walk away. The skill will monitor their progress, update your experiment plan, and notify you when everything is complete, allowing you to focus on analysis.

Quick Start

Assuming an experiment has been scaffolded and finetune.slurm files exist:

claude run-experiment

The skill will submit jobs and monitor their progress,

updating experiment_summary.md automatically until all jobs are complete.

Frequently Asked Questions about Run Experiment

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

FAQPage Schema
How do I automate SLURM job submission and monitoring for fine-tuning experiments?

Automating SLURM job submission involves coordinating fine-tuning jobs with torchtune and evaluation with inspect-ai across all runs defined in experiment_summary.yaml. This Skill orchestrates end-to-end model experimentation by submitting jobs with appropriate staggering, polling SLURM status in real-time, and updating your experiment summary automatically until completion.

What's the best way to manage multiple fine-tuning runs on an HPC cluster without manual monitoring?

Submit all finetune.slurm jobs at once and let automation handle tracking. This Skill enforces dependency order (optimization before evaluation), monitors job states via squeue and sacct, logs comprehensive progress, and updates experiment_summary.md with job IDs and completion times—freeing you to focus on analysis.

Can I use this with torchtune and inspect-ai for end-to-end LLM experimentation?

Yes. This Skill is designed to orchestrate torchtune-based fine-tuning followed by inspect-ai evaluation. It reads experiment_summary.yaml, invokes both optimizer and evaluator modules sequentially, enforces completion of optimization before evaluation begins, and handles errors including partial successes.

Do I need to manually check job status or handle staggering to avoid cache conflicts?

No. This Skill automatically stagger-submits finetune.slurm jobs to prevent cache issues, continuously polls SLURM for status updates (PENDING, RUNNING, COMPLETED, FAILED), and logs all progress—eliminating the need for manual oversight.

What happens if a fine-tuning job fails during a multi-run experiment?

This Skill handles errors including partial successes and missing artifacts. It logs comprehensive error details to run-experiment.log, maintains state in experiment_summary.md, and ensures dependency order is enforced so incomplete optimization steps prevent evaluation from running.

What files and setup do I need before running this automation?

You need experiment_summary.yaml defining all runs, finetune.slurm job scripts for each run, and a working SLURM environment. This Skill parses the experiment configuration, validates scaffolding, and coordinates torchtune and inspect-ai modules—no additional setup required.