autoresearch

Improves existing skills through controlled prompt mutation experiments and binary evaluations.

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/nugiwabot/marketing-branding-selling-ads-skills --skill autoresearch-nugiwabot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: autoresearch
Source: https://github.com/nugiwabot/marketing-branding-selling-ads-skills/tree/main/.agents/skills/autoresearch
Command: npx skills add https://github.com/nugiwabot/marketing-branding-selling-ads-skills --skill autoresearch-nugiwabot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Iterating on AI skill prompts often relies on guesswork, leading to changes that feel better but actually regress quality, break evidence discipline, or overfit to a single test case. This Skill replaces ad-hoc prompt tweaking with a controlled experiment loop that produces measurable, documented improvements. ## Core Features & Use Cases - Controlled Mutation Loop: Establishes a baseline, changes one variable at a time, runs the same evaluation suite, and keeps or discards each mutation based on evidence. - Binary Eval Design Guidance: Includes a reference guide for writing yes/no evaluation criteria that resist gaming and produce reliable signals across runs. - Guardrails and Promotion Gate: Prevents optimizing toward fabricated claims or narrow metrics, and requires documented results before promoting a mutated skill to production. - Use Case: A marketing skill produces inconsistent positioning outputs. Define 4 binary evals, run a baseline, test targeted prompt mutations one at a time, log each experiment, and promote only the version that improves scores without regressions. ## Quick Start Use the autoresearch skill to run a controlled experiment improving the messaging-positioning skill with binary evals and a mutation log.

Frequently Asked Questions about autoresearch

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

FAQPage Schema
How do I improve an AI skill prompt with experiments?

Run a controlled mutation loop: establish a baseline score on representative test inputs, change one variable at a time, re-run the same binary eval suite, and keep only mutations that show measurable improvement without regressions. Log every experiment with its hypothesis and result.

How to write good evaluation criteria for AI prompts?

Write binary yes/no evals that test observable behavior, not scales or subjective judgments. Each eval should be specific enough that two different scorers agree, resistant to gaming, and tied to something the user actually cares about. Keep 3-6 evals maximum.

When should I stop iterating on prompt mutations?

Stop when the experiment budget is reached, improvements hit diminishing returns, repeated mutations fail to improve results, or remaining failures require new evidence or redesign rather than prompt wording. Never run an unconditional infinite optimization loop.

What are the limitations of automated prompt optimization?

Prompt mutation cannot fix a wrong strategic boundary, missing evidence, or a flawed skill design. If experiments reveal the skill's role or authority is misdefined, escalate the design issue instead of optimizing around it. Narrow metrics can also reward gaming over genuine improvement.

Can autoresearch change what a skill is allowed to decide?

No. Autoresearch optimizes how a skill executes its defined job, but it must not silently change the skill's strategic purpose, decision authority, or evidence standards to improve an eval score. Boundary problems are escalated, not optimized around.