# autoresearch

The autoresearch skill runs repeated code experiments against a measurable target. Use it for tuning tests, builds, bundle size, or ML training results.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 137 installs · ★ 129 repo stars
- Author: Factory-AI
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Factory-AI/factory-plugins/tree/HEAD/plugins/autoresearch/skills/autoresearch/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/factory-ai-autoresearch

## What it does

autoresearch sets up a repeatable optimization session around a command and a named metric. The agent changes files in scope, runs the measurement, compares the result with the current best, and keeps or reverts the change. It also supports a termination rule such as an experiment count, time budget, target value, or interruption.

The setup uses a Git branch plus `autoresearch.md`, `autoresearch.sh`, and `autoresearch.jsonl`. An optional `autoresearch.checks.sh` handles required tests or type checks. The log records experiment outcomes, while MAD-based confidence scoring helps assess noisy measurements. The loop cannot start without a measurable metric.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Factory-AI/factory-plugins --skill autoresearch -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/autoresearch/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/autoresearch/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Factory-AI/factory-plugins --skill autoresearch -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/autoresearch/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Factory-AI/factory-plugins --skill autoresearch -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/autoresearch/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Factory-AI/factory-plugins plugins/autoresearch/skills/autoresearch
```

2. **Manually: put the files in place**
- File: `.github/skills/autoresearch/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Factory-AI/factory-plugins --skill autoresearch -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Factory-AI/factory-plugins --path plugins/autoresearch/skills/autoresearch
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/autoresearch/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Factory-AI/factory-plugins --skill autoresearch -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Factory-AI/factory-plugins/tree/HEAD/plugins/autoresearch/skills/autoresearch/SKILL.md

## When to use it
- define a measurable optimization target
- record a baseline with `autoresearch.sh`
- compare trials against the current best result
- revert changes that worsen the metric
- keep hypotheses and outcomes in JSONL

## Example prompts
- Set up autoresearch to reduce the runtime reported by `pnpm test` and limit the editable files.
- Create `autoresearch.sh`, measure the baseline, and log it in `autoresearch.jsonl`.
- Run another experiment, compare its metric with the best result, and revert the change if it regresses.

## Similar
- [autoresearch-agent](https://affpapa.org/en/nevibecode/skills/autoresearch-agent.md) — skill · 589 installs
- [dueling-autoresearch](https://affpapa.org/en/nevibecode/skills/dueling-autoresearch.md) — skill · ★ 185 repo stars
- [skill-autoresearch](https://affpapa.org/en/nevibecode/skills/skill-autoresearch.md) — skill · 323 installs
- [ar-run](https://affpapa.org/en/nevibecode/skills/ar-run.md) — skill · ★ 30251 repo stars
- [tournament-autoresearch](https://affpapa.org/en/nevibecode/skills/tournament-autoresearch.md) — skill · ★ 185 repo stars
- [arbor](https://affpapa.org/en/nevibecode/skills/arbor.md) — skill · 1500 installs

## Other versions with the same name
- [autoresearch · github](https://affpapa.org/en/nevibecode/skills/autoresearch.md) — 3400 installs
- [autoresearch · uditgoenka](https://affpapa.org/en/nevibecode/skills/uditgoenka-autoresearch.md) — 2700 installs
- [autoresearch · yeachan-heo](https://affpapa.org/en/nevibecode/skills/yeachan-heo-autoresearch.md) — 654 installs
- [autoresearch · orchestra-research](https://affpapa.org/en/nevibecode/skills/orchestra-research-autoresearch.md) — 1200 installs
- [autoresearch · agricidaniel](https://affpapa.org/en/nevibecode/skills/agricidaniel-autoresearch.md) — 572 installs

From the same set: [factory-ai/factory-plugins](https://affpapa.org/en/nevibecode/by/factory-ai/factory-plugins.md) — 17 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
