run-experiment

Deploy and execute machine learning experiments on local or remote GPU servers via SSH.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/MACJONSW/AutoResearchIDEA --skill run-experiment-macjonsw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-experiment
Source: https://github.com/MACJONSW/AutoResearchIDEA/tree/main/skills/run-experiment
Command: npx skills add https://github.com/MACJONSW/AutoResearchIDEA --skill run-experiment-macjonsw

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the deployment and execution of machine learning experiments, whether on local hardware or remote GPU servers, simplifying the MLOps workflow.

Core Features & Use Cases

  • Environment Detection: Automatically identifies the target environment (local GPU or remote server) by reading CLAUDE.md.
  • Pre-flight Checks: Verifies GPU availability before allocating resources.
  • Code Synchronization: Efficiently syncs only necessary code files to remote servers.
  • Deployment: Launches experiments in isolated screen sessions (remote) or background processes (local) with GPU binding.
  • Verification & Notification: Confirms experiment launch and optionally sends notifications.
  • Use Case: Launch a PyTorch training job on a remote A100 GPU server, ensuring sufficient memory is available and the code is up-to-date, then receive a confirmation once it's running.

Quick Start

Use the run-experiment skill to deploy the attached script 'train.py' with arguments '--epochs 10 --lr 0.001' to the remote server defined in CLAUDE.md.

Frequently Asked Questions about run-experiment

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

FAQPage Schema
How do I deploy and run machine learning experiments on a remote GPU server via SSH?

To deploy and run ML experiments on a remote GPU server, the skill automates SSH connections, syncs necessary code files, verifies GPU availability, and launches the training job in an isolated screen session. It reads target environment configurations from CLAUDE.md to ensure accurate deployment.

Can I run PyTorch training jobs on local machines with CUDA or MPS?

Yes, you can run PyTorch training jobs on local machines with CUDA or MPS. The skill automatically detects the local hardware environment, performs pre-flight GPU availability checks, and launches the experiment as a background process with appropriate GPU binding.

What is the best way to automate MLOps workflows for training jobs across different environments?

Automating MLOps workflows for training jobs requires environment detection, code synchronization, and resource allocation. This skill standardizes the process by reading configuration files, verifying GPU memory, binding resources, and managing processes using screen and conda across local or remote setups.

How does code synchronization work when deploying experiments to remote GPU servers?

Code synchronization for remote GPU servers works by efficiently transferring only the necessary code files over SSH. The skill identifies required files locally and syncs them to the remote server before deployment, ensuring the target environment has the up-to-date code needed to run the experiment.

Do I need conda and screen to manage remote training jobs?

You need conda and screen to manage remote training jobs because the skill uses conda for environment isolation and screen to launch experiments in persistent isolated sessions. This ensures processes continue running after SSH disconnection and provides verification of successful job launches.

Why does my ML experiment deployment fail due to insufficient GPU memory?

ML experiment deployment may fail due to insufficient GPU memory if resources are already allocated. The skill performs pre-flight checks to verify GPU availability and memory before deployment, preventing launch failures and ensuring efficient resource utilization on the target machine.