/exp-run

Execute wiki-planned experiments by generating code, deploying, and collecting metrics.

1.6k|208|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/skyllwt/AutoSci --skill exp-run-skyllwt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: /exp-run
Source: https://github.com/skyllwt/AutoSci/tree/main/.claude/skills/exp-run
Command: npx skills add https://github.com/skyllwt/AutoSci --skill exp-run-skyllwt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

It eliminates the repetitive, error-prone workflow of turning a planned experiment spec in the wiki into runnable code, deploying it (locally or remotely), monitoring it, and collecting standardized results back into the wiki.

Core Features & Use Cases

  • End-to-end experiment execution: prepares experiment code under experiments/code/{slug}/, deploys it, monitors run status, and collects results.
  • Three run modes: deploy-only, collect-only, or full end-to-end runs for different experiment timelines.
  • Safety guardrails: requires explicit user confirmation before deployment and includes dataset/config inspection and a small-scale sanity check.
  • Wiki-integrated outputs: updates wiki/experiments/{slug}.md (status, outcomes, key_result, dates, logs) and appends wiki/log.md, while saving results as JSON under results/{slug}/seed_{N}.json.

Quick Start

Run the deployment for the planned experiment by telling the AI: "Deploy and monitor the planned experiment with slug 'my-exp' locally, and after a user confirmation and sanity checks, start the run."

Frequently Asked Questions about /exp-run

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

FAQPage Schema
How do I automate experiment deployment and collect results back into a wiki?

Automating experiment deployment involves generating code from a wiki spec, running it locally or remotely via SSH, and persisting JSON results. This workflow updates the wiki with status, metrics, and mean±std outcomes automatically.

Can I run just the deployment or collection phase separately for my experiment?

Yes, you can execute deploy-only or collect-only modes independently. This allows splitting the experiment lifecycle, so you can deploy code first and collect standardized metrics later without a full end-to-end run.

What safety checks are applied before running experiment code remotely?

Before running experiment code remotely, the system requires explicit user confirmation, validates datasets and configs, and executes a small-scale sanity check. These guardrails prevent erroneous deployments and ensure config correctness.

How does wiki experiment tracking handle multiple seed runs for statistical reporting?

Wiki experiment tracking handles multiple seed runs by saving individual run outcomes as JSON files under results/{slug}/seed_{N}.json. It then aggregates these results to report mean±std metrics in the wiki experiment markdown file.

Do I need an LLM to review generated experiment code before local deployment?

An LLM code review is optional before local deployment. You can proceed with the experiment execution after passing the mandatory user confirmation gate and dataset validation checks without the LLM review.

What is the best way to manage an experiment lifecycle from wiki planning to result collection?

The best way to manage an experiment lifecycle is using a full end-to-end run mode. It generates code from wiki/experiments/{slug}.md, applies sanity checks, deploys via remote SSH, and appends outcomes and logs back to the wiki.