auto-research

Run closed-loop hypothesis-test-evaluate optimization on SKILL.md files with binary criteria.

7|1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/Agent-Engineer-Master/skill-engineer --skill auto-research-agent-engineer-master
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: auto-research
Source: https://github.com/Agent-Engineer-Master/skill-engineer/tree/main/operations/auto-research
Command: npx skills add https://github.com/Agent-Engineer-Master/skill-engineer --skill auto-research-agent-engineer-master

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Autonomously runs a closed-loop hypothesis→test→evaluate→keep/discard optimization on a target SKILL.md (or CLAUDE.md), producing an updated skill file and an iteration dashboard (baseline score, each hypothesis, keep/discard decision, improvement delta). This enables measurable, binary-criteria-driven skill refinement without manual rewriting.

Core Features & Use Cases

  • Three isolated sub-agents handle testing and evaluation while a central orchestrator guides the workflow.
  • Automates criteria design, test harness creation, and rigorous evaluation with binary pass/fail checks.
  • Produces an updated skill file and an iteration dashboard suitable for audit and governance.

Quick Start

Run Auto Research on a target SKILL.md to start a closed-loop optimization that designs criteria, generates test inputs, evaluates outputs, and applies approved changes to the skill.

Frequently Asked Questions about auto-research

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

FAQPage Schema
How do I automate Claude skill optimization for measurable output quality?▼

Automating Claude skill optimization requires executing a closed hypothesis, test, evaluate, and keep/discard loop that updates the target skill file and generates an iteration dashboard. This approach uses binary-criteria frameworks to ensure deterministic improvements with human approval before writing changes.

What is the best way to evaluate LLM skill output against binary pass/fail criteria?▼

Evaluating LLM skill output against binary pass/fail criteria is best done using isolated sub-agents for testing and evaluation. This rigorous evaluation method automates criteria design and test harness creation to measure output quality deterministically.

Can I use auto-research to update a CLAUDE.md file without manual rewriting?▼

Yes, you can use auto-research to update a CLAUDE.md file without manual rewriting. It autonomously runs a closed-loop optimization on the target file, applying approved changes and producing an iteration dashboard for audit and governance.

How does the hypothesis testing loop work when refining Claude skills?▼

The hypothesis testing loop works by having a central orchestrator guide three isolated sub-agents that handle testing and evaluation. It designs criteria, generates test inputs, evaluates outputs, and applies only approved changes back to the original skill file.

Do I need a binary-criteria framework to improve skill output quality?▼

Yes, a binary-criteria framework is required to ensure deterministic improvements in skill output quality. It provides the necessary pass/fail checks for the evaluation sub-agents to measure improvement delta accurately during the optimization loop.

What are the limitations of using sub-agents for autonomous skill engineering?▼

A limitation of using sub-agents for autonomous skill engineering is the requirement for human approval before writing changes back to the original file. The system also relies entirely on a binary-criteria framework to measure deterministic improvements.