
Run
- 1.5k installs
- 23.5k repo stars
- Updated July 17, 2026
- alirezarezvani/claude-skills
run is an agent skill that Run a single experiment iteration. Edit the target file, evaluate, keep or discard.
About
Run a single experiment iteration. Edit the target file, evaluate, keep or discard. --- name: "run" description: "Run a single experiment iteration. Edit the target file, evaluate, keep or discard." command: /ar:run --- # /ar:run - Single Experiment Iteration Run exactly ONE experiment iteration: review history, decide a change, edit, commit, evaluate. ## Usage ``` /ar:run engineering/api-speed # Run one iteration /ar:run # List experiments, let user pick ``` ## What It Does ### Step 1: Resolve experiment If no experiment specified, run `python {skill_path}/scripts/setup_experiment.py --list` and ask the user to pick. ### Step 2: Load context ```bash # Read experiment config cat .autoresearch/{domain}/{name}/config.cfg # Read strategy and constraints cat .autoresearch/{domain}/{name}/program.md # Read experiment history cat .autoresearch/{domain}/{name}/results.tsv # Checkout the experiment branch git checkout autoresearch/{domain}/{name} ``` ### Step 3: Decide what to try Review results.tsv: - What changes were kept?
- /ar:run - Single Experiment Iteration
- Read experiment config
- Read strategy and constraints
- Read experiment history
- Checkout the experiment branch
Run by the numbers
- 1,461 all-time installs (skills.sh)
- +2 installs in the week ending Jul 29, 2026 (Skillselion tracking)
- Ranked #325 of 4,353 Backend & APIs skills by installs in the Skillselion catalog
- Security screen: MEDIUM risk (skills.sh audit)
- Data as of Jul 31, 2026 (Skillselion catalog sync)
run capabilities & compatibility
- Capabilities
- /ar:run — single experiment iteration · read experiment config · read strategy and constraints · read experiment history · checkout the experiment branch
- Use cases
- documentation
What run says it does
--- name: "run" description: "Run a single experiment iteration.
{metric}: {value} ({delta} from previous best)" - **DISCARD**: "No improvement.
Reverted." - **CRASH**: "Evaluation failed: {reason}.
Reverted." ### Step 7: Self-improvement check After every 10th experiment (check results.tsv line count), update the Strategy section of program.md with patterns learned.
npx skills add https://github.com/alirezarezvani/claude-skills --skill runAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 1.5k |
|---|---|
| repo stars | ★ 23.5k |
| Security audit | 2 / 3 scanners passed |
| Last updated | July 17, 2026 |
| Repository | alirezarezvani/claude-skills ↗ |
What problem does run solve for developers using this skill?
Run a single experiment iteration. Edit the target file, evaluate, keep or discard.
Who is it for?
Developers who need run patterns described in the cached skill documentation.
Skip if: Skip when docs are empty or the task is outside the skill's documented scope.
When should I use this skill?
Run a single experiment iteration. Edit the target file, evaluate, keep or discard.
What you get
Actionable workflows and conventions from SKILL.md for run.
- committed code edit
- eval results
- experiment history update
Files
../../../engineering/autoresearch-agent/skills/run/SKILL.md
Related skills
How it compares
Pick run over setup when an experiment already exists and you need to execute an iteration, not create configuration.
FAQ
What does run do?
Run a single experiment iteration. Edit the target file, evaluate, keep or discard.
When should I use run?
Run a single experiment iteration. Edit the target file, evaluate, keep or discard.
Is run safe to install?
Review the Security Audits panel on this page before installing in production.