Agent skill

Autoresearch

by moedesux in moedesux/autoresearch-opencode

Set up and run an autonomous experiment loop for any optimization target.

No licenceAuto-check: warningsAgent Workflows

Install Autoresearch

The automated check flagged lines worth reading first. See the safety section below.

skills CLI
$ npx skills add moedesux/autoresearch-opencode --skill autoresearch -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install moedesux/autoresearch-opencode autoresearch --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/moedesux/autoresearch-opencode.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/autoresearch .claude/skills/autoresearch && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
autoresearch
GitHub stars
199
Token cost
~4.2k tokens
SKILL.md length
1,330 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
None found

At a glance

Set up and run an autonomous experiment loop for any optimization target.

  • Works in 6 steps: Determine status → Git operations → Append result to JSONL → …
  • Asked to start autoresearch
  • SKILL.md covers Setup, JSONL State Protocol, Data Integrity Protocol and Running Experiments…, plus 9 more sections
  • Calls git, python3 and bash

What it does

Autoresearch is an agent skill from moedesux/autoresearch-opencode. Set up and run an autonomous experiment loop for any optimization target. Use when asked to start autoresearch or run experiments.

Its SKILL.md is about 4.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Autonomous loops.

When your agent uses it

  • Asked to start autoresearch
  • Run experiments

Example prompts

  • “/autoresearch”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Determine status
  2. Git operations
  3. Append result to JSONL
  4. Update dashboard
  5. Append to worklog
  6. Secondary metric consistency

What it can do on your machine

Read from SKILL.md and the folder at commit 679a331. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • python3
    • bash

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Autoresearch loads about 4.2k tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 1,330 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~36
When it runs · the whole SKILL.md, loaded when a task matches
~4.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: warnings

The automated check found patterns that need a careful read before installing.

  • WarningTells the agent its actions are pre-authorized / not to stop for confirmationSKILL.md:475
    Finish your current experiment first — don't stop or ask for confirmation. Incorporate the user's idea in the next expe

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 1,330 words (~4,223 tokens).

“Autonomous experiment loop: try ideas, keep what works, discard what doesn't, never stop.”

— opening of SKILL.md by moedesux
name
autoresearch

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/autoresearch of moedesux/autoresearch-opencode.

Open the folder on GitHubat commit 679a331

Compare with similar skills

Autoresearch next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Autoresearch compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Autoresearch this skillmoedesux/autoresearch-opencode199—~4.2kAutomated safety check: WarnNone
Show Me Your Work Decision Logcursor/plugins11k8 repos~1.6kAutomated safety check: PassNone
Autoresearch Iteration Loopuditgoenka/autoresearch6.5k1 repos~2kAutomated safety check: PassMIT
Install Loop Engineeringcobusgreyling/loop-engineering11k1 repos~648Automated safety check: PassMIT
LoopyForward-Future/loopy3.2k—~3.9kAutomated safety check: PassMIT
AI Performance Improvement Plantanweai/pua20k2 repos~6.9kAutomated safety check: PassMIT

Similar skills

  • Official

    Keeps a TSV decision log for long or unattended agent runs, one row per decision with what, why, evidence and result, so a reviewer can check the work later.

    11k GitHub starsUsed in 8 repos~1.6k tokens
    Agent WorkflowsAuto-check passed
  • Autoresearch Iteration Loop

    uditgoenka/autoresearch

    Runs an autonomous modify, verify, keep-or-discard loop against any metric, with subcommands for planning, debugging, fixing, security audits, shipping and more.

    6.5k GitHub starsUsed in 1 repo~2k tokens
    Agent WorkflowsAuto-check passed
  • Install Loop Engineering

    cobusgreyling/loop-engineering

    Installs Loop Engineering into a project through the single @cobusgreyling/loop CLI, scaffolding a report-only loop and a readiness score.

    11k GitHub starsUsed in 1 repo~648 tokens
    Agent WorkflowsAuto-check passed
  • Loopy

    Forward-Future/loopy

    Discover, find, compare, audit, repair, adapt, craft, run, debrief, save, and prepare repeatable AI-agent loops for publication.

    3.2k GitHub stars~3.9k tokensUpdated 29 days ago
    Agent WorkflowsAuto-check passed
  • Pushes an agent to exhaust every option, investigate before asking and take initiative beyond the literal request, instead of giving up or waiting passively.

    20k GitHub starsUsed in 2 repos~6.9k tokens
    Agent WorkflowsAuto-check passed
  • LoopX Self Repair

    loopx-project/loopx

    Diagnoses surprising LoopX behavior, such as stale recommendations or tiny progress, assigns it to the responsible layer and repairs it at the lowest durable level.

    6.2k GitHub stars~2.2k tokensUpdated today
    Agent WorkflowsAuto-check passed

Categories

Questions about Autoresearch

What does Autoresearch do?

Set up and run an autonomous experiment loop for any optimization target. Autoresearch is an agent skill from moedesux/autoresearch-opencode. Set up and run an autonomous experiment loop for any optimization target.

When should I use Autoresearch?

Autoresearch fits situations like: asked to start autoresearch; run experiments.

How do I install Autoresearch in Claude Code?

Run `npx skills add moedesux/autoresearch-opencode --skill autoresearch -a claude-code`. Or copy the skill folder (skills/autoresearch in moedesux/autoresearch-opencode) into .claude/skills/autoresearch in your project. Claude Code loads it when a task matches its description.

How do I install Autoresearch in Codex?

Run `npx skills add moedesux/autoresearch-opencode --skill autoresearch -a codex`. Or copy the skill folder (skills/autoresearch in moedesux/autoresearch-opencode) into .agents/skills/autoresearch in your project. Codex loads it when a task matches its description.

Can I use Autoresearch in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add moedesux/autoresearch-opencode --skill autoresearch -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/autoresearch, .gemini/skills/autoresearch, .github/skills/autoresearch and .opencode/skills/autoresearch in your project.

What does Autoresearch need to run?

Going by SKILL.md and its folder, Autoresearch needs the command-line tools its instructions call (git, python3 and bash). Our summary lists: Python 3.

Does Autoresearch access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Autoresearch safe to install?

Our automated static check of SKILL.md flagged 1 warning(s): tells the agent its actions are pre-authorized / not to stop for confirmation. Read the flagged lines before installing; the check is not a guarantee either way.

What licence does Autoresearch use?

No licence was found for Autoresearch or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Autoresearch use?

About 4.2k tokens (SKILL.md is roughly 17k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Autoresearch?

Skills that share tags, products or a category with Autoresearch: Show Me Your Work Decision Log (cursor/plugins, 11k stars), Autoresearch Iteration Loop (uditgoenka/autoresearch, 6.5k stars), Install Loop Engineering (cobusgreyling/loop-engineering, 11k stars) and Loopy (Forward-Future/loopy, 3.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Autoresearch?

moedesux (a GitHub user) maintains it in moedesux/autoresearch-opencode, which has 199 GitHub stars. The repository was last updated on March 29, 2026.

Source: moedesux/autoresearch-opencode on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.