experiment-queue

Orchestrate ML experiment batches on SSH GPU servers with OOM retry.

Updated Jun 7, 2026
One-click install
npx skills add https://github.com/czh-ee-2023/zotero-aris --skill experiment-queue-czh-ee-2023
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: experiment-queue
Source: https://github.com/czh-ee-2023/zotero-aris/tree/main/.claude/skills/experiment-queue
Command: npx skills add https://github.com/czh-ee-2023/zotero-aris --skill experiment-queue-czh-ee-2023

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires queue_manager.py, build_manifest.py, and includes scripts (resource) components.

What problem does it solve?

This Skill automates the orchestration of large batches of ML experiments on SSH remote GPU servers, providing OOM-aware retry, stale-screen cleanup, and wave-transition race prevention.

Core Features & Use Cases

  • Batch Experiment Orchestration: Handles ≥10 jobs that need batching across GPUs.
  • Multi-seed Sweeps: Supports 21 seeds × 12 cells and similar grid experiments.
  • Wave Transitions: Manages wave 1, wait, wave 2, wait, wave 3... without races.
  • Teacher+student Chains: Automates training teacher then distilling student.
  • OOM Retry: Retries with different GPU or waits for memory release.
  • Mixed Seed Grids: Re-runs failed cells in mixed seed grids.

Quick Start

Run the experiment queue for your manifest or grid spec using the command: /experiment-queue manifest-or-grid-spec

Frequently Asked Questions about experiment-queue

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

FAQPage Schema
How do I run multi-seed ML experiments on remote GPU servers without crashing from OOM?

Running multi-seed ML experiments on remote GPU servers without crashing requires OOM-aware retry logic that waits for memory release or switches GPUs. This orchestration skill automates large job batches over SSH, retrying failed tasks and cleaning up stale screens to prevent memory exhaustion.

What is the best way to orchestrate wave transitions for teacher and student training chains?

The best way to orchestrate wave transitions for teacher and student chains is using a queue manager that enforces sequential wave execution. This skill schedules wave 1, waits, then transitions to wave 2 without race conditions, automating the distillation pipeline across mixed seed grids.

Can I batch ten or more ML jobs across multiple GPUs using SSH?

Yes, you can batch ten or more ML jobs across multiple GPUs using SSH. This skill handles batch experiment orchestration for large job counts, distributing tasks across available remote GPUs and re-running failed cells in mixed seed grids.

Do I need specific scripts to automate large ML experiment sweeps on remote servers?

Yes, you need specific scripts to automate large ML experiment sweeps on remote servers. This skill requires queue_manager.py for scheduling and build_manifest.py for manifest generation, which together coordinate multi-seed sweeps and prevent wave-transition races.

Why does my SSH screen session become stale during long GPU experiment runs?

SSH screen sessions become stale during long GPU experiment runs due to unhandled process terminations or memory bottlenecks. This skill prevents stale screens by incorporating cleanup mechanisms and OOM-aware retry logic to maintain active session integrity.

How do I re-run failed cells in a mixed seed grid for ML experiments?

To re-run failed cells in a mixed seed grid, you need an orchestration tool that tracks job success states and automatically retries failures. This skill identifies failed cells within 21 seeds x 12 cells grids and re-executes them while preventing wave-transition races.