autoresearch

Run repeated experiments with binary evals to optimize SKILL.md prompts.

Updated May 15, 2026
One-click install
npx skills add https://github.com/JBonfim/skill-developer --skill autoresearch-jbonfim
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: autoresearch
Source: https://github.com/JBonfim/skill-developer/tree/main/.agents/skills/autoresearch
Command: npx skills add https://github.com/JBonfim/skill-developer --skill autoresearch-jbonfim

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill reduces the chance of “garbage” skill outputs by running an autonomous optimization loop that repeatedly tests, scores, and incrementally mutates a target SKILL.md until it improves measurable quality. It solves the problem of unreliable skill performance by converting subjective behavior into binary evaluations and using those signals to guide prompt changes.

Core Features & Use Cases

  • Autonomous experimentation loop: Runs the target skill many times with fixed test inputs, scores each output, and keeps only beneficial prompt mutations.
  • Binary eval suite design: Helps define 3–6 yes/no checks that act as pass/fail “test questions” for consistent scoring.
  • Live progress dashboard: Generates a self-contained HTML dashboard that auto-refreshes and visualizes score progression and per-eval breakdown.
  • Research logging artifacts: Produces results.tsv, results.json, changelog.md, and a saved baseline SKILL.md.baseline for auditability and repeatability.
  • Targeted prompt mutations: Applies one focused change at a time to avoid overfitting and to isolate what improves results.

Quick Start

Start autoresearch for the skill whose SKILL.md you want optimized, after confirming the target skill path, 3–5 test inputs, and 3–6 binary eval criteria with the user.

Frequently Asked Questions about autoresearch

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

FAQPage Schema
How do I improve Claude Code skill prompts automatically?

To improve Claude Code skill prompts automatically, you can use an autonomous experimentation loop that repeatedly tests fixed inputs, scores outputs with binary yes/no evals, and applies targeted mutations to the SKILL.md until quality measurably increases.

What is binary scoring in prompt benchmarking?

Binary scoring in prompt benchmarking is an evaluation method that defines 3–6 yes/no checks as pass/fail test questions for each output, converting subjective skill behavior into consistent signals to guide prompt mutations.

How do I set up autonomous experimentation for skill evaluation?

To set up autonomous experimentation for skill evaluation, you must confirm the target skill path, provide 3–5 fixed test inputs, and define 3–6 binary eval criteria to establish a baseline before the mutation loop begins.

How does targeted prompt mutation prevent overfitting in skill optimization?

Targeted prompt mutation prevents overfitting in skill optimization by applying one focused change at a time to the SKILL.md, isolating exactly which mutations improve binary eval scores before keeping or discarding the change.

What artifacts are generated during autonomous skill optimization?

During autonomous skill optimization, the process generates research logging artifacts including a baseline SKILL.md.baseline, results.tsv, results.json, changelog.md, and a self-contained auto-refreshing HTML dashboard visualizing score progression.

When should I stop the autonomous prompt mutation loop?

You should stop the autonomous prompt mutation loop when a predefined budget is reached or a convergence condition is met, ensuring the skill evaluation process halts once incremental binary score improvements diminish.