autoresearch

Automate iterative code experiments that keep only metric-improving changes.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/mmahalwy/cooper --skill autoresearch-mmahalwy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: autoresearch
Source: https://github.com/mmahalwy/cooper/tree/main/.agents/skills/autoresearch
Command: npx skills add https://github.com/mmahalwy/cooper --skill autoresearch-mmahalwy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Autoresearch automates the repetitive, error-prone process of manually trying code changes, running measurements, and reverting regressions so you can systematically optimize a measurable metric in a codebase.

Core Features & Use Cases

  • Interactive setup: Walks the user through defining a clear goal, an exact metric command and extraction rule, in-scope and out-of-scope files, constraints, and experiment budget.
  • Autonomous experiment loop: Creates a branch, commits experiments, runs the metric command, extracts results, keeps improvements, and reverts regressions while logging each attempt to results.tsv.
  • Safe guardrails: Respects out-of-scope files, requires user approval for environment changes, enforces baseline measurements, and limits experiments according to user constraints.
  • Use cases: Performance tuning, reducing build or binary size, improving test pass rates, or any optimization where an exact command produces a numeric metric.

Quick Start

Tell the agent your optimization goal, provide the exact command and extraction rule to measure it, specify which files it may modify, list any constraints and the experiment budget, then confirm to begin.

Frequently Asked Questions about autoresearch

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

FAQPage Schema
How do I automate iterative code experimentation to optimize runtime or bundle size?

Automated iterative code experimentation modifies code, runs a user-defined metric command, and keeps only changes that measurably improve the numeric metric while reverting regressions. You provide the exact command, extraction rule, and target files to optimize metrics like runtime or bundle size.

What is autonomous code optimization and how does it handle performance tuning?

Autonomous code optimization creates a git branch, commits experimental changes, runs your measurement command, and extracts numeric results to keep improvements and revert regressions. It logs each attempt to results.tsv, automating performance tuning by systematically testing code modifications against a baseline metric.

Can I use autonomous experimentation on any git-backed codebase to reduce binary size?

Yes, autonomous experimentation works on any git-backed codebase where you can provide a reproducible command outputting a numeric metric like binary size. It requires terminal and git access, permission to modify in-scope files, and the ability to create commits and branches while logging results.

How do I set up constraints and file scope for autonomous code benchmarking?

Interactive setup walks you through defining optimization goals, exact metric commands, extraction rules, in-scope and out-of-scope files, constraints, and experiment budgets. Safe guardrails respect out-of-scope files, require approval for environment changes, enforce baseline measurements, and limit experiments to your constraints.

What are the limitations of autonomous iterative experimentation for test pass rates?

Autonomous iterative experimentation requires a reproducible command producing a numeric metric, limiting use cases where measurements cannot be automated. It also requires explicit user approval for environment changes and cannot modify out-of-scope files, constraining optimizations to defined boundaries.

Do I need git and terminal access to run autonomous code optimization loops?

Yes, autonomous code optimization requires terminal and git access to create branches and commits. You must also provide an explicit metric command with an extraction rule, have permission to modify in-scope files, and be able to log experiment results throughout the optimization loop.