autoresearch

Automate iterative code experiments to optimize a measurable metric.

1|1|Updated May 3, 2026
One-click install
npx skills add https://github.com/matt-riley/agent-skills --skill autoresearch-matt-riley
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: autoresearch
Source: https://github.com/matt-riley/agent-skills/tree/main/skills/autoresearch
Command: npx skills add https://github.com/matt-riley/agent-skills --skill autoresearch-matt-riley

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

Automate iterative experiments to optimize a measurable metric on an existing codebase — removing manual trial-and-error and enabling budget-guided exploration.

Core Features & Use Cases

  • Autonomous metric-driven exploration that hill-climbs improvements to performance, build times, coverage, or other measurable goals.
  • Configurable inputs: define the Goal, Metric command, Metric extraction, Direction, and In-scope/Out-of-scope files to control the scope and safety of experiments.
  • Use Case: apply it to optimize a project's CI build time by running automated experiments that apply code changes and record outcomes.

Quick Start

Start by defining a goal, metric command, extraction method, and scope, then kick off the autonomous experiment loop.

Frequently Asked Questions about autoresearch

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

FAQPage Schema
How do I automate codebase optimization to improve measurable metrics?

Automated codebase optimization runs iterative experiments, applies code changes autonomously, measures numeric outcomes, and keeps or reverts changes based on budget-guided exploration until a goal is reached.

What inputs do I need to start an autonomous experimentation loop for my code?

Autonomous experimentation requires a clearly defined Goal, a Metric command producing a numeric value, a Metric extraction method, a Direction setting like lower_is_better, and in-scope or out-of-scope files to confine edits.

Can I use metric-driven exploration to reduce CI build times?

Metric-driven exploration can optimize CI build times by running automated experiments that apply code changes, measure the resulting build duration, and retain improvements that lower the measured metric.

How do I restrict automated code changes to specific files during benchmarking?

You restrict automated code changes by defining in-scope and out-of-scope files before starting the experiment loop, confining edits to targeted areas and preventing modifications to the rest of the codebase.

What happens when a code change does not improve the target metric?

When a code change does not improve the target metric, the autonomous loop reverts the changes and continues hill-climbing improvements through further iterative experiments within the defined budget.

Does autonomous codebase optimization work without manual trial-and-error?

Autonomous codebase optimization removes manual trial-and-error by automatically running code changes, extracting metric values, and deciding to keep or revert modifications based on the specified optimization direction.