Skip to content
Skill

Autoresearch

Autonomous iterative experimentation loop for any programming task

Install
Scripts
None
Platforms
Claude Code, Codex, Cursor
GitHub stars
41.3K
Last commit
1 day ago
License
MIT
Listing updated
today

When your agent uses it

Autonomous iterative experimentation loop for any programming task. Guides the user through defining goals, measurable metrics, and scope constraints, then runs an autonomous loop of code changes, testing, measuring, and keeping/discarding results. Inspired by Karpathy's autoresearch. USE FOR: autonomous improvement, iterative optimization, experiment loop, auto research, performance tuning, automated experimentation, hill climbing, try things automatically, optimize code, run experiments, autonomous coding loop. DO NOT USE FOR: one-shot tasks, simple bug fixes, code review, or tasks without a measurable metric.

From the skill's SKILL.md. Your agent reads this description to decide when to load the skill.

What it can access

From a static check of its 1 file (11 KB) on GitHub on 17 November 2026. Nothing was run. Read the files before you install a skill: it can tell your agent to run anything its tools allow.

Install

Copy the skill folder to ~/.claude/skills/autoresearch to use it in all your projects:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/autoresearch &&
cp -R "$tmp/skills/autoresearch" ~/.claude/skills/autoresearch &&
rm -rf "$tmp"

For one project only, put the folder in .claude/skills/autoresearch inside it instead.

Claude Code docs on skills

Copy the skill folder to ~/.agents/skills/autoresearch to use it in every repository:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/autoresearch &&
cp -R "$tmp/skills/autoresearch" ~/.agents/skills/autoresearch &&
rm -rf "$tmp"

For one repository only, put the folder in .agents/skills/autoresearch inside it instead.

Codex docs on skills

Copy the skill folder to ~/.cursor/skills/autoresearch to use it in every project:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/autoresearch &&
cp -R "$tmp/skills/autoresearch" ~/.cursor/skills/autoresearch &&
rm -rf "$tmp"

For one project only, put the folder in .cursor/skills/autoresearch inside it instead.

Cursor docs on skills

Run in a terminal (add --scope workspace to install it for the current workspace only):

gemini skills install https://github.com/github/awesome-copilot.git --path skills/autoresearch

Or copy the folder to ~/.gemini/skills/autoresearch yourself.

Gemini CLI docs on skills

For GitHub Copilot in VS Code, copy the skill folder to ~/.copilot/skills/autoresearch:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/autoresearch &&
cp -R "$tmp/skills/autoresearch" ~/.copilot/skills/autoresearch &&
rm -rf "$tmp"

For one project only, put the folder in .github/skills/autoresearch inside it instead.

VS Code docs on skills

Get the folder:

git clone --depth 1 https://github.com/github/awesome-copilot.git

Then copy awesome-copilot/skills/autoresearch into your agent's skills folder as autoresearch. Agents that support SKILL.md read one folder per skill.

The SKILL.md format

Autoresearch FAQ

How do I install Autoresearch in Claude Code?

Copy the skill folder from GitHub to ~/.claude/skills/autoresearch to use it in all your projects, or to .claude/skills/autoresearch in one project.

Does Autoresearch run scripts?

No. It is instructions only, with no scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.

Which AI agents can use Autoresearch?

Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.

More from github/awesome-copilot

  1. Design or review infrastructure, deployment, CI/CD, Docker, Kubernetes, health checks, rollback, feature flags, production readiness, and mo

    • Open source
    • 41.3K GitHub stars
    • Cloud and infrastructure
  2. Stop coding agents from shipping generic UI

    • Open source
    • 41.3K GitHub stars
  3. Cross-references C# Web API controllers/DTOs against their TypeScript/JavaScript consumers (React, Angular, Vue, Svelte, Node.js, or hand-wr

    • Open source
    • 41.3K GitHub stars
  4. Serves as a reviewer of the codebase with instructions on looking for Apple App Store optimizations or rejection reasons.

    • Open source
    • 41.3K GitHub stars
  5. Triage and resolve Arch Linux issues with pacman, systemd, and rolling-release best practices.

    • Open source
    • 41.3K GitHub stars