30-SECOND BRIEF
What it does—and when it fits
Autoresearch is a GitHub Awesome Copilot workflow for autonomous, metric-driven programming experiments. After the user defines the goal, measurement command, scope, constraints, and budget, it establishes a baseline and repeatedly commits, measures, keeps improvements, and discards regressions.
INSTALL BY AGENT
Choose your Agent
Paths come from official Agent docs or the universal installer behind skills.sh. Compatibility still follows this Skill's record.
.agents/skills/autoresearch/~/.copilot/skills/autoresearch/Use project scope for team sharing and personal scope across repositories. The installer defaults to project scope; add -g for personal scope.
npx skills add github/awesome-copilot --skill autoresearch --agent github-copilotCopilot also accepts .github/skills and .claude/skills at project scope. Preview untrusted Skills before enabling scripts.
View path evidence ↗TYPICAL WORKFLOW
A practical workflow
Define a measurable experiment
Agree on one numeric metric, direction, scope, and constraints.
Run controlled iterations
Commit each hypothesis, execute the metric, and log the result.
Keep only winners
Revert equal, worse, or failed experiments while preserving the journal.
THE TRADEOFFS
Advantages and tradeoffs
Notable strengths
- A baseline and experiment ledger make optimization results auditable.
- Explicitly values simpler improvements and discards measurable regressions.
Limitations
- Only fits tasks with a stable, representative numeric metric.
- Local metric gains can overfit the benchmark or degrade qualities the metric does not capture.
BEST FIT
Who it is for
Developers optimizing performance, coverage, size, or another testable outcome
Teams that can isolate an experimentation branch and review kept changes
BEFORE YOU USE IT
Risks to review before use
Autonomous repository mutation
The loop commits changes and reverts failed experiments repeatedly. Use a dedicated branch, protect out-of-scope files, back up uncommitted work, and set a finite budget.
SECURITY
What the permission profile means
- Never expose secrets through metric output or run logs.
- Review every kept commit before merging because the metric is not a correctness proof.
Not a security certification. External ratings are attributed references. SkillSignal has not independently executed or security-reviewed this Skill.
INSIDE THE PACKAGE
Indexed files
TAGS
Original SkillSignal editorial profile grounded in GitHub Awesome Copilot commit 318066d2, checked 2026-08-20; not independently executed or security-certified.