autoresearch

Run hypothesis-driven experiments, measure outcomes, and decide whether to keep or discard changes.

88|108|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/grandamenium/cortextos --skill autoresearch-grandamenium
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: autoresearch
Source: https://github.com/grandamenium/cortextos/tree/main/templates/analyst/.claude/skills/autoresearch
Command: npx skills add https://github.com/grandamenium/cortextos --skill autoresearch-grandamenium

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you turn vague performance improvement goals into measurable, repeatable experimentation cycles with clear decisions to keep or discard changes.

Core Features & Use Cases

  • Research-cycle execution: Runs a hypothesis → change → measure → evaluate loop aligned to a configured metric, surface, direction, and measurement window.
  • Evidence-based evaluation: Measures outcomes using the cycle’s configured method (quantitative scripted/computed or qualitative scoring with required justification).
  • Experiment governance: Supports approval-gated experiment creation and logs learnings for every run, including failures, to avoid repeating discarded hypotheses.
  • Use case: Optimize a specific operational metric for an agent fleet (for example, improving “system_effectiveness”) by testing targeted modifications to a surface file and evaluating results against a baseline.

Quick Start

Assign and run an autoresearch cycle by telling the analyst to start a research cycle for the metric you want to improve, then wait for the experiments to be created and evaluated.

Frequently Asked Questions about autoresearch

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

FAQPage Schema
How do I automate structured experiments to optimize agent metrics?

Automating structured experiments requires running hypothesis-driven cycles that measure outcomes against a baseline. This Skill executes a loop of targeted modifications, evaluates results using configured quantitative or qualitative methods, and decides whether to keep or discard changes. It logs all learnings to prevent repeating discarded hypotheses.

What is the scientific method applied to agent orchestration and metric optimization?

The scientific method applied to agent orchestration involves iterating through hypothesis testing, implementing git-commit-based changes, measuring outcomes over a defined window, and evaluating performance against a baseline. This structured iteration ensures operational metrics improve through evidence-based decisions rather than guesswork.

How do I set up a research cycle for hypothesis testing and performance analytics?

Setting up a research cycle involves defining the target metric, surface, direction, and measurement window. You assign the cycle by instructing the analyst to start, and the system automatically gathers context from the shared bus, creates experiments, and evaluates results.

Can I require approval before creating experiments in an automated research cycle?

Yes, automated research cycles support approval-gated experiment creation. This governance feature ensures that proposed changes are reviewed before execution, maintaining control over the optimization process while still automating the measurement and evaluation phases.

Does this experimentation workflow support qualitative evaluation methods?

Yes, the workflow supports qualitative evaluation methods alongside quantitative scripted computations. Qualitative scoring requires explicit justification, ensuring that non-numeric assessments still provide structured, evidence-based reasoning for keeping or discarding changes.

What happens to failed hypotheses in an automated experimentation loop?

Failed hypotheses are explicitly logged as learnings in every run. Recording these failures is mandatory to avoid repeating discarded hypotheses, ensuring the iterative optimization process continuously refines its approach based on both successful and unsuccessful experiments.