autoresearch-loop

Automate iterative optimization on targets.jsonl with LLM-generated hypotheses and patches.

Updated Feb 23, 2026
One-click install
npx skills add https://github.com/ASRagab/asragab-claude-marketplace --skill autoresearch-loop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: autoresearch-loop
Source: https://github.com/ASRagab/asragab-claude-marketplace/tree/main/plugins/skill-eval/skills/autoresearch-loop
Command: npx skills add https://github.com/ASRagab/asragab-claude-marketplace --skill autoresearch-loop

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @anthropic-ai/sdk, and includes scripts (resource) components.

What problem does it solve?

Automate autoresearch-style optimization on a target identified by M3. It generates improvements via an LLM, evaluates them against the target's eval questions, and keeps improvements that beat the best score, while tracking all experiments in a JSONL state file.

Core Features & Use Cases

  • Automated hypothesis generation and concrete patches via LLM
  • Evaluation against predefined eval questions with retention of top-performing improvements
  • JSONL-based experiment state tracking with support for history, dry-run, and summaries

Quick Start

Run the autoresearch loop on the top target using bun scripts/autoresearch-loop.ts -t targets.jsonl --max-rounds 20

Frequently Asked Questions about autoresearch-loop

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

FAQPage Schema
How do I automate LLM optimization experiments against predefined eval questions?

Automating LLM optimization experiments involves generating hypotheses and concrete patches, evaluating them against target eval questions, and retaining top-performing improvements. This Skill iterates through that loop and stores all experiment rounds in a JSONL state file.

How do I track experiment state and history for iterative LLM optimization?

Tracking experiment state for iterative LLM optimization requires storing each round's hypotheses, patches, and evaluation scores. This Skill uses a JSONL state file to maintain complete experiment history, supports dry-runs, and generates summaries of the optimization process.

What dependencies do I need to run automated LLM evaluation loops?

Running automated LLM evaluation loops requires the Bun runtime, the @anthropic-ai/sdk package, and a valid ANTHROPIC_API_KEY. The Skill uses these dependencies to generate patches and evaluate improvements against your targets.

Can I apply iterative optimization to a list of targets stored in a JSONL file?

Iterative optimization can be applied to targets stored in a JSONL file by passing the file path to the script. It processes targets by generating improvements, evaluating them against predefined questions, and keeping only those that beat the best score.

What is the best way to generate and evaluate concrete patches for LLM state management?

The best way to generate and evaluate patches is through an iterative loop that proposes changes via an LLM and scores them. This Skill automates this by generating concrete patches, evaluating them against target criteria, and saving only improvements that outperform previous best scores.