run-experiment

Deploys ML experiments to local, SSH, Vast.ai, or Modal GPUs with verification.

Updated May 20, 2026
One-click install
npx skills add https://github.com/lightrain-a/medtrace-aris --skill run-experiment-lightrain-a
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-experiment
Source: https://github.com/lightrain-a/medtrace-aris/tree/main/.vendor/aris/skills/run-experiment
Command: npx skills add https://github.com/lightrain-a/medtrace-aris --skill run-experiment-lightrain-a

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of getting ML experiments running end-to-end without manually wiring up local GPUs, remote SSH servers, Vast.ai instances, or Modal serverless GPUs.

Core Features & Use Cases

  • Environment-aware deployment: Detects whether the target is local GPU, a configured remote server, Vast.ai, or Modal based on CLAUDE.md settings.
  • Pre-flight GPU validation: Checks GPU availability (e.g., free VRAM thresholds) before starting remote or local runs.
  • Code sync + logging support: Synchronizes only necessary code (rsync by default, or git/pull workflow when configured) and optionally auto-instruments training scripts for Weights & Biases (W&B).
  • Execution + verification: Launches jobs using screen sessions for remote/Vast.ai (or background/local) and provides commands to verify that jobs started successfully.
  • Cost control for rented GPUs: For Vast.ai with auto-destroy enabled, it supports result/log collection and instance teardown to stop billing.

Quick Start

Ask the AI to run experiment by saying: "Run experiment to train my model with batch size 32 for 3 epochs."

Frequently Asked Questions about run-experiment

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

FAQPage Schema
How do I run ML experiments on remote GPUs without manual SSH setup?

To run ML experiments on remote GPUs, this Skill detects your environment via CLAUDE.md, synchronizes code to SSH servers, Vast.ai, or Modal, and launches jobs automatically. It performs pre-flight GPU checks and uses screen sessions for execution.

Can I deploy machine learning jobs to Vast.ai and automatically stop billing?

Yes, you can deploy to Vast.ai and control costs by enabling auto-destroy. The Skill provisions instances, launches training, collects results and logs, and tears down the instance to stop billing automatically upon completion.

Does Modal serverless work for launching machine learning training scripts?

Modal serverless is fully supported for launching machine learning training scripts. When Modal is detected in your configuration, the Skill delegates to a serverless-modal launcher to orchestrate the deployment and execution of your jobs.

What is the best way to sync code and log metrics with W&B for remote GPU training?

The best way to sync code and log metrics for remote GPU training is using built-in rsync or git/pull workflows. The Skill synchronizes necessary files and optionally auto-instruments your training scripts for Weights & Biases (W&B) logging.

How do I verify that a remote ML training job started successfully?

To verify a remote ML training job started successfully, the Skill provides specific verification commands after launch. It initiates runs using screen sessions or background processes and supplies the exact commands needed to check job status.

Do I need to manually check VRAM availability before deploying to local GPUs?

No, you do not need to manually check VRAM availability before deploying to local GPUs. The Skill performs pre-flight GPU validation automatically, querying free VRAM thresholds to ensure the local GPU meets requirements before starting the run.