Back to Skills

resume

Resume a paused experiment. Checkout the experiment branch, read results history, continue iterating. Use when the user runs /ar:resume or asks to pick up a previously started autoresearch experiment.

24,553stars3,452forksUpdated 8/17/2026

Security Assessment

Safe(95/100)
Security Score95/100

About resume

This skill implements the `/ar:resume` command for an autoresearch experiment workflow, letting a user pick up a previously started, paused, or context-limited experiment exactly where they left off. The problem it solves is continuity: long-running iterative experiments accumulate history in a branch and a results file, and re-establishing that context by hand is tedious and error-prone. The skill reads all of the prior state and produces a concise summary so work can continue without restarting.

The workflow is a small, read-oriented sequence. If no experiment is named, it lists available experiments via a setup script and shows each one's status (active, paused, or done) based on the age of a results.tsv file. Once an experiment is selected, it checks out the experiment's git branch, reads the config, strategy program, full results history, and the recent git log, then reports the current state: target file, optimization metric, counts of kept versus discarded versus crashed experiments, the best result relative to baseline, and observed patterns across change types. Finally it asks the user how to continue, offering a single iteration (/ar:run), an autonomous loop (/ar:loop), or a results review, and hands off accordingly.

The intended users are developers and researchers using this autoresearch agent framework to iteratively optimize code against a measurable metric such as latency. It is a thin orchestration/planning skill: its own logic is limited to reading history and routing to sibling commands, so its usefulness depends on the surrounding autoresearch tooling being present.

FAQ

What does /ar:resume do?

It resumes a paused or context-limited autoresearch experiment by checking out its git branch, reading the config, strategy, and full results history, summarizing current state, and asking how to continue.

What happens if I do not specify an experiment?

It runs the setup script with --list to enumerate experiments, shows each one's status (active, paused, or done) based on results.tsv age, and lets you pick one.

What are the prerequisites?

It expects the broader autoresearch framework: git branches named autoresearch/{domain}/{name}, a .autoresearch state directory with config.cfg, program.md, and results.tsv, and the sibling /ar:run and /ar:loop commands.

Does it change my code automatically?

No. Resume itself only reads history and reports state, then hands off to /ar:run or /ar:loop based on your choice for any actual iteration.

Install resume

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill