Agent skill

Autoresearch

by haibarazz in haibarazz/awesome-codex-research

Run rigorous end-to-end autonomous ML and AI research after a user provides a dataset, target, and research budget.

No licenceAuto-check passedAgent Workflows

Install Autoresearch

skills CLI
$ npx skills add haibarazz/awesome-codex-research --skill autoresearch -a claude-code

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

GitHub CLI
$ gh skill install haibarazz/awesome-codex-research 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/haibarazz/awesome-codex-research.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
100
Token cost
~2.2k tokens
SKILL.md length
919 words
Files
105 (incl. scripts, references, assets)
Skills in repo
9
Repo updated
First seen
Licence
None found

At a glance

Run rigorous end-to-end autonomous ML and AI research after a user provides a dataset, target, and research budget.

  • Works in 5 steps: infer exactly one current Phase from the… → consider only PHASE documents whose… → among those documents, read only files… → …
  • AutoResearch must inspect
  • SKILL.md covers Mandatory First Read, Activation Router, Codebase Bootstrap Boundary and Runtime Boundary, plus 3 more sections
  • Runs JavaScript scripts from its folder; calls python3

What it does

Autoresearch is an agent skill from haibarazz/awesome-codex-research. Run rigorous end-to-end autonomous ML and AI research after a user provides a dataset, target, and research budget. Use when AutoResearch must inspect or safely bootstrap a missing codebase with ReproFlow, align and freeze the research brief, then independently analyze literature, reproduce methods, run and repair experiments, promote research bases, and continue until the performance target is reached or the preregistered budget is exhausted, while remaining reproducible and avoiding pseudo-innovation.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 110 other files, including scripts, reference files and assets (for example `agents/openai.yaml`, `assets/schemas/experiment_graph.schema.json` and `assets/schemas/runtime_request.schema.json`).

It sits in Agent Workflows, covering Autonomous loops and Deep research.

When your agent uses it

  • AutoResearch must inspect
  • Safely bootstrap a missing codebase with ReproFlow
  • Align and freeze the research brief
  • Then independently analyze literature

Example prompts

  • “/autoresearch”

Requirements

  • Python 3
  • Node.js

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. infer exactly one current Phase from the frozen contracts and project artifacts;
  2. consider only PHASE documents whose activation.phases includes that Phase;
  3. among those documents, read only files whose read_when matches the immediate action;
  4. read ON_DEMAND files only while generating, updating, or validating their artifact;
  5. complete the current action and its exit checks before selecting the next Phase.

What it can do on your machine

Read from SKILL.md and the folder at commit e3ca125. 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

    Ships 1 file in scripts/ (JavaScript, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

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

  • Network

    No URLs in SKILL.md.

    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 2.2k tokens when it runs, and up to ~40k if it reads all its reference files. Until then it costs about 130 tokens; SKILL.md has 919 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~130
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~40k

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 passed

The automated check found no risky patterns in SKILL.md.

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); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 919 words (~2,222 tokens).

“Use this project-local skill when the user wants to provide a dataset and research target, complete one startup alignment, and then delegate the entire research process to AI. After the Research Brief is frozen, the AI runs the evidence-producing research…”

— opening of SKILL.md by haibarazz
name
autoresearch

Read the full SKILL.md on GitHub

Files

SKILL.md and 104 other files (scripts, references, assets) in skills/autoresearch of haibarazz/awesome-codex-research.

  • SKILL.md
  • agents/openai.yaml
  • assets/candidate_priority_combinations.csv
  • assets/schemas/experiment_graph.schema.json
  • assets/schemas/runtime_request.schema.json
  • assets/schemas/runtime_response.schema.json
  • assets/schemas/runtime_state.schema.json
  • assets/workflow.css
  • assets/workflow.js
  • examples/golden-run/.autoresearch/runtime_state.json
  • examples/golden-run/BENCHMARK.md
  • examples/golden-run/EXPERIMENT_GRAPH.html
  • examples/golden-run/EXPERIMENT_GRAPH.json
  • examples/golden-run/README.md
  • examples/golden-run/RESEARCH_BRIEF.md
  • … and 90 more

Open the folder on GitHubat commit e3ca125

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 skillhaibarazz/awesome-codex-research100—~2.2kAutomated safety check: PassNone
LoopX Auto-Research Workerloopx-project/loopx6.2k—~3.5kAutomated safety check: PassApache-2.0
Slate Ar Qualityudecode/plate17k—~474Automated safety check: PassCustom licence
Show Me Your Work Decision Logcursor/plugins11k8 repos~1.6kAutomated safety check: PassNone
Autoresearch Iteration Loopuditgoenka/autoresearch6.5k1 repos~2kAutomated safety check: PassMIT
Bounded AutoresearchAgriciDaniel/claude-obsidian15k—~1.6kAutomated safety check: PassMIT

Similar skills

  • LoopX Auto-Research Worker

    loopx-project/loopx

    Role playbook for a LoopX worker running an auto-research lane, with execution checklists, artifact contracts and stop conditions.

    6.2k GitHub stars~3.5k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Slate Ar Quality

    udecode/plate

    Slate v2 quality-gap Autoresearch shortcut. An agent skill from udecode/plate.

    17k GitHub stars~474 tokensUpdated today
    Testing & QAAuto-check passed
  • 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
  • Bounded Autoresearch

    AgriciDaniel/claude-obsidian

    Runs a bounded, source-grounded research loop that drafts a cited dossier and can propose a separately reviewed merge into an Obsidian vault.

    15k GitHub stars~1.6k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-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

More from haibarazz/awesome-codex-research

All 9 skills in this repo
  • Cds Method Innovation

    haibarazz/awesome-codex-research

    Guide a complete baseline-first ML or computational data-science method-innovation project, from workspace and direction discovery through finding and running common and recent baselines, diagnosing…

    100 GitHub stars~715 tokensUpdated 17 days ago
    Auto-check passed
  • Autodl Remote

    haibarazz/awesome-codex-research

    A skill your agent uses when the host coding agent should control an AutoDL or SSH server from the local machine, run remote commands, and explicitly upload or download selected files.

    100 GitHub stars~2.7k tokensUpdated 17 days ago
    Auto-check passed
  • Autodl Remote Tmux

    haibarazz/awesome-codex-research

    A skill your agent uses when AutoDL Remote should run or monitor long remote jobs through tmux panes.

    100 GitHub stars~666 tokensUpdated 17 days ago
    Auto-check passed
  • Auto Exp

    haibarazz/awesome-codex-research

    Plan, execute, monitor, verify, compare, and document reproducible machine-learning experiments.

    100 GitHub stars~1.4k tokensUpdated 17 days ago
    Auto-check passed
  • Research Literature Review

    haibarazz/awesome-codex-research

    面向信息系统计算设计科学(CDS)研究,根据用户的数据、研究情境与研究问题,分别识别问题/理论视角和技术/算法两条文献对话线,检索并核验全文,制作可追溯的文献对话地图,最终澄清研究的最近邻、理论祖先、方法缺口与可辩护定位。适用于选题定位、相关工作规划、方法定位和后续综述;核心不是代写文献综述。

    100 GitHub stars~558 tokensUpdated 17 days ago
    Auto-check passed
  • Review Comment Decomposer

    haibarazz/awesome-codex-research

    结合论文原文拆解审稿意见为最小可回应原子问题,规划补实验与回复构思两条工作线,归组共同关切,并输出带忠实中文翻译注释、每条 comment 一份建议逻辑和原子点英文小标题的可编译 LaTeX 回复骨架。用于返修规划、review decomposition、atomic concerns、rebuttal strategy 和回复信模板生成;完整回复正文留待作者后续撰写。

    100 GitHub stars~1.1k tokensUpdated 17 days ago
    Auto-check: warnings

Categories

Questions about Autoresearch

What does Autoresearch do?

Run rigorous end-to-end autonomous ML and AI research after a user provides a dataset, target, and research budget. Autoresearch is an agent skill from haibarazz/awesome-codex-research. Run rigorous end-to-end autonomous ML and AI research after a user provides a dataset, target, and research budget.

When should I use Autoresearch?

Autoresearch fits situations like: autoResearch must inspect; safely bootstrap a missing codebase with ReproFlow; align and freeze the research brief; then independently analyze literature.

How do I install Autoresearch in Claude Code?

Run `npx skills add haibarazz/awesome-codex-research --skill autoresearch -a claude-code`. Or copy the skill folder (skills/autoresearch in haibarazz/awesome-codex-research) 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 haibarazz/awesome-codex-research --skill autoresearch -a codex`. Or copy the skill folder (skills/autoresearch in haibarazz/awesome-codex-research) 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 haibarazz/awesome-codex-research --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 JavaScript for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3; Node.js.

Does Autoresearch access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Autoresearch safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

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 2.2k tokens (SKILL.md is roughly 8.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 38k tokens, read only when the agent opens those files.

What are the alternatives to Autoresearch?

Skills that share tags, products or a category with Autoresearch: LoopX Auto-Research Worker (loopx-project/loopx, 6.2k stars), Slate Ar Quality (udecode/plate, 17k stars), Show Me Your Work Decision Log (cursor/plugins, 11k stars) and Autoresearch Iteration Loop (uditgoenka/autoresearch, 6.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Autoresearch?

haibarazz (a GitHub user) maintains it in haibarazz/awesome-codex-research, which has 100 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on September 23, 2026.

Source: haibarazz/awesome-codex-research on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.