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.