Autoresearch

Research better approaches, generate SKILL.md variations, score them, and update via PR.

6|2|Updated May 21, 2026
One-click install
npx skills add https://github.com/anajuliabit/aeon --skill autoresearch-anajuliabit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Autoresearch
Source: https://github.com/anajuliabit/aeon/tree/main/skills/autoresearch
Command: npx skills add https://github.com/anajuliabit/aeon --skill autoresearch-anajuliabit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Autoresearch reduces skill rot by automatically improving an existing skill through targeted research, generating multiple improved versions, and selecting the best option without manual trial-and-error.

Core Features & Use Cases

  • Skill evolution via evidence: Reads the target skill’s purpose, data sources, output format, and dependencies, then searches for better approaches and common failure modes.
  • Multi-variant improvement loop: Produces four distinct SKILL.md variations (better inputs, sharper output, more robust handling, and a fundamentally different rethinking).
  • Rubric-based selection and safe updating: Scores variations with explicit criteria and only applies the winner if it beats the baseline on improvement.
  • Operational integration: Logs progress to memory/logs and sends a structured notification via ./notify, including the scoring summary and PR details.

Quick Start

Run autoresearch with var set to the skill you want improved, for example: "Evolve the token-movers skill by running autoresearch with var=token-movers and returning the PR for the best variation."

Frequently Asked Questions about Autoresearch

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

FAQPage Schema
How do I automatically improve an existing AI agent skill?

Automatically improve an existing AI agent skill by researching better approaches, generating multiple SKILL.md variations, and scoring them against a weighted rubric to select the best version.

What is the best way to prevent skill rot in automated prompt workflows?

Prevent skill rot in automated prompt workflows by running a continuous improvement loop that evaluates target skills against new approaches and applies safe updates only when variations outperform the baseline.

How do I generate and test multiple variations of a markdown skill file?

Generate and test multiple variations of a markdown skill file by producing four distinct alternatives, scoring each against explicit rubric criteria, and submitting the winning version via a GitHub PR.

Can I automatically update GitHub PRs with better performing AI agent skills?

Automatically update GitHub PRs with better performing AI agent skills by applying rubric-based selection, preserving required frontmatter conventions, and skipping the update when no improvement over the baseline is found.

Does this self-healing automation approach work without manual trial-and-error?

This self-healing automation works without manual trial-and-error by evaluating four variations across better inputs, sharper outputs, robust error handling, and a fundamentally different methodology to ensure safe skill evolution.

What are the limitations of using rubric scoring for skill evolution?

A limitation of using rubric scoring for skill evolution is that it strictly avoids regressions by skipping updates when an improvement is not found, meaning no PR is created if variations fail to beat the baseline.