autoresearch

Orchestrates autonomous AI research projects using a two-loop experiment and synthesis architecture.

2|Updated Aug 15, 2026
One-click install
npx skills add https://github.com/Jensen-Yao/agents-skills --skill autoresearch-jensen-yao
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: autoresearch
Source: https://github.com/Jensen-Yao/agents-skills/tree/main/skills/0-autoresearch-skill
Command: npx skills add https://github.com/Jensen-Yao/agents-skills --skill autoresearch-jensen-yao

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires semanticscholar, arxiv, weasyprint, and includes references (resource) components.

What problem does it solve? Running a multi-hypothesis AI research project requires constant experiment iteration, literature tracking, and synthesis that humans cannot sustain continuously. This Skill turns an AI agent into an autonomous research project manager that keeps experiments running, records results, and steers research direction without human supervision. ## Core Features & Use Cases - Two-Loop Research Engine: An inner loop runs rapid experiments with locked protocols and measurable metrics, while an outer loop synthesizes patterns, updates findings, and decides whether to deepen, broaden, pivot, or conclude. - Continuous Agent Operation: Sets up a mandatory 20-minute wall-clock loop via Claude Code /loop or OpenClaw cron so research never stalls between sessions, with workspace files (research-state.yaml, findings.md, research-log.md) acting as persistent memory. - Domain Skill Routing and Paper Output: Routes execution tasks to domain skills (training, evaluation, interpretability, MLOps) and produces progress presentations plus a final paper via the ml-paper-writing skill. - Use Case: You want to investigate whether sleep-like consolidation phases accelerate grokking in small transformers. The skill bootstraps a literature survey, forms hypotheses, runs dozens of experiments overnight, and delivers a trajectory plot, findings narrative, and paper draft. ## Quick Start Start an autonomous research project on my question about efficient transformer architectures, set up the workspace and continuity loop, and keep running experiments until you can write the paper.

Frequently Asked Questions about autoresearch

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

FAQPage Schema
How do I run autonomous AI research experiments with an agent?▼

Initialize the workspace with research-state.yaml, findings.md, and research-log.md, then set up the mandatory 20-minute continuity loop via Claude Code /loop or an OpenClaw cron job. The agent then runs inner-loop experiments and outer-loop synthesis cycles without further input.

What is the two-loop architecture for autonomous research?▼

The inner loop runs fast experiment cycles: pick a hypothesis, lock a protocol in git, run the experiment, measure the metric, and record results. The outer loop periodically reviews accumulated results, identifies patterns, updates findings.md, and decides to deepen, broaden, pivot, or conclude.

Does autoresearch work with OpenClaw and Claude Code?▼

Yes, both platforms are supported. Claude Code uses the /loop 20m command, while OpenClaw uses a cron.add job with everyMs 1200000 bound to the current session. Both fire a continuation prompt every 20 minutes to keep research moving.

How does the agent keep context between research sessions?▼

Context persists through workspace files, not conversation memory. research-state.yaml tracks hypotheses and experiment trajectories, findings.md stores the synthesized narrative, and research-log.md records the decision timeline. The agent reads these at every loop tick.

What happens when autonomous research experiments stall?▼

The skill instructs the agent to run an outer-loop reflection, search literature via Exa MCP, Semantic Scholar, or arXiv, or invoke research ideation skills for new hypotheses. Negative results are logged as progress with what they rule out rather than treated as failure.

When should I use autoresearch instead of individual ML skills?▼

Use autoresearch when you have an open research question requiring iterative experimentation and synthesis beyond a single metric. For one-off tasks like training a model, running an evaluation, or writing a paper, invoke the relevant domain skill directly instead.