autoresearch

Mutate SKILL.md files through iterative test and scoring loops.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/ste-bah/archon --skill autoresearch-ste-bah
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: autoresearch
Source: https://github.com/ste-bah/archon/tree/main/.claude/skills/autoresearch
Command: npx skills add https://github.com/ste-bah/archon --skill autoresearch-ste-bah

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables autonomous, iterative improvement of Claude Code skills by mutating the target SKILL.md, running a battery of tests, and scoring outputs against a binary rubric. It orchestrates a repeatable autoresearch loop that records results and learns from failures to drive progressive enhancements.

Core Features & Use Cases

  • Autonomous mutation of SKILL.md to improve clarity, constraints, and testability while preserving the skill's purpose.
  • Deterministic evaluation through test-case execution and binary scoring, with git-based rollback for safe experimentation.
  • Use Case: You want to enhance a Claude Code skill's reliability and performance by running multiple tiny, atomic mutations and selecting those that yield objective improvements.

Quick Start

Run autoresearch <skill-name> to begin an iterative improvement cycle for that skill.

Frequently Asked Questions about autoresearch

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

FAQPage Schema
How do I automate iterative skill improvement for Claude Code?

Automate iterative skill improvement by mutating SKILL.md files, running test batteries, and scoring outputs against a binary rubric. This autonomous loop applies atomic mutations and Git-based rollback to safely enhance skill reliability and performance progressively.

How does Git-based rollback work during autonomous skill mutation?

Git-based rollback ensures safe experimentation during autonomous skill mutation by automatically reverting SKILL.md changes if test cases fail. Atomic mutations are scored against a binary rubric, allowing only objective improvements to persist while discarding failed iterations.

What is binary scoring in automated AI testing workflows?

Binary scoring in automated AI testing evaluates skill outputs as strict pass or fail against a deterministic rubric. This evaluation method removes ambiguity from autonomous improvement loops, ensuring only mutations that yield objective enhancements are retained.

Can I run autonomous mutation loops on existing SKILL.md files without dependencies?

Yes, autonomous mutation loops run on existing SKILL.md files without external dependencies. The workflow coordinates a three-phase process of Setup, Loop, and Debrief, storing all test artifacts locally under the .autoresearch directory.

What are the limitations of using atomic mutations for code quality improvement?

Atomic mutations for code quality improvement are limited to tiny, isolated changes in SKILL.md files to preserve the skill's original purpose. The system enforces binary-only scoring, which may not capture nuanced qualitative improvements in skill clarity.

What is the best way to evaluate AI testing results from skill improvement loops?

Evaluate AI testing results from skill improvement loops by reviewing stored artifacts in the .autoresearch directory during the Debrief phase. This workflow records test case executions and binary scoring outcomes to audit progressive enhancements and analyze failures.