autoresearch

Runs bounded autonomous research loops that evaluate committed candidates against saved objectives through TORC.

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/cameronbracken/waterology-research --skill autoresearch-cameronbracken
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: autoresearch
Source: https://github.com/cameronbracken/waterology-research/tree/main/skills/autoresearch
Command: npx skills add https://github.com/cameronbracken/waterology-research --skill autoresearch-cameronbracken

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Iterative research and engineering work often degrades into ad hoc shell loops, hand-kept metric logs, and lost experiment history. This Skill enforces a managed, gated workflow where every candidate is committed, evaluated through a pinned TORC profile, and archived as durable evidence, so results stay comparable and reproducible. ## Core Features & Use Cases - Managed study lifecycle: Creates NestedText study contracts with objective, acceptance rules, and budgets, then drives candidates through waterology study create, enqueue, advance, and watch. - Durable evidence and reproducibility: Seals run archives, exports RO-Crates, and verifies final deliverables with deliverable register and reproduce in an isolated directory. - Engineering and research modes: Supports both specification-driven optimization and scientific question answering, with an optional experiment-tree discipline for multi-decision studies. - Use Case: A researcher wants to calibrate a hydrological model against a benchmark. The Skill registers the evaluation workflow, saves a contract with a metric target and iteration budget, then iterates committed candidate branches until acceptance or budget limits are reached. ## Quick Start Ask the assistant to start an autoresearch study that optimizes your model's benchmark metric with a defined iteration budget and let it set up the managed workflow.

Frequently Asked Questions about autoresearch

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

FAQPage Schema
How do I run an autonomous experiment loop to optimize a research metric?▼

Register your evaluation command with waterology workflow register, write a NestedText contract with the objective, acceptance rule, and budgets, then run waterology study create and study advance. The controller queues candidates through TORC and archives every result.

How to resume an interrupted Waterology study?▼

Resume by reading the existing study record with waterology study show, then continue with study watch or study run using the saved study ID. The contract, budgets, and archived evidence persist, so no fresh approval or restart is needed.

Can I use a shell loop instead of the managed study workflow?▼

No. The Skill explicitly prohibits substituting shell loops, direct invocations, or hand-kept metric logs for the managed gates. If Waterology commands are unavailable, the correct behavior is to report the missing capability and stop.

Does autoresearch work for local compute without a cluster?▼

Yes. Local compute still uses the study's pinned TORC profile, such as the local profile, for every candidate evaluation. Direct execution outside TORC is never allowed, even for lightweight local runs.

When should I use experiment tree mode instead of the linear loop?▼

Use tree mode when a study spans several distinct design decisions rather than one metric with sequential edits. It organizes candidates as stacked bushes of Git branches with a frozen baseline, fixed run contract, and recorded promotion rules.

What happens when a candidate evaluation fails?▼

Failed and unfavorable runs are retained as archived evidence rather than deleted. The controller retries within the saved policy, and unresolved failures remain blocked with the exact recovery action recorded.