autoresearch
Autonomous iteration loop: modify, verify, keep/discard against any metric
npx skills add uditgoenka/autoresearch --skill autoresearch --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Autoresearch — Autonomous Goal-directed Iteration ## Safety Invariants (all subcommands) - Never push, publish, or deploy without explicit user approval. - Bounded by default. Override with `Iterations: unlimited`. - All results logged to `autoresearch/{subcommand}-{YYMMDD}-{HHMM}/` directory. - Chain handoff via `handoff.json`. Evals reads `*-results.tsv`. ## Dispatch (bare `$autoresearch`) Parse the invocation in this order: | Condition | Mode | |---|---| | `Metric:` or `Verify:` present | **Classic** — existing metric loop, unchanged | | Free-form natural-language goal, no metric/verify | **Orchestrator** — see Orchestrator section | | Nothing | **Setup wizard** — interactive config builder | | `--classic` flag | Force Classic regardless of goal text | | `--auto` flag | Force Orchestrator regardless of goal text | Print a banner on every invocation: `[autoresearch] mode: classic | orchestrator | wizard`. ## Subcommands | Command | Does | Default Iterations | |---|---|---| | `$autoresearch` | Iterate against a metric: modify → verify → keep/discard | 25 | | `$autoresearch plan` | Convert a goal into validated Scope, Metric, Verify config | N/A | | `$autoresearch debug` | Hunt b
- Safety Invariants (all subcommands)
- Dispatch (bare $autoresearch)
- Subcommands
- Universal Flags
- Orchestrator
- Orchestration Loop Steps
- Orchestrator State
- Orchestrator Safety Invariants
What does the autoresearch skill do?
Autonomous iteration loop: modify, verify, keep/discard against any metric
How do I install it?
Run `npx skills add uditgoenka/autoresearch --skill autoresearch --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From uditgoenka/autoresearch, a repository with 5,753 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.