# skill-autoresearch

Runs edits to skills, prompts and SOPs through a frozen local benchmark: one change per run, then keep or revert.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 322 installs · ★ 50
- Author: akillness
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/skill-autoresearch/SKILL.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/skill-autoresearch

## What it does

The skill takes a single repo artifact — `SKILL.md`, an SOP, a prompt template or a workflow doc — and pushes it through a bounded improvement loop. It starts by asking whether the loop is warranted at all. The current version may already clear the bar, or the only real drift may sit in the supporting files. Without evidence of headroom, the run stops there.

When the loop does go ahead, `loop-charter.md` is written first. That charter pins the goal, the current baseline, the one mutable artifact, the evaluation harness, which supporting files are in scope, and the time and iteration budget. The evaluator stays untouched afterwards: a single meaningful change goes in, the same harness runs again, and both wins and reverts land in an append-only log that lives in git and survives PR review.

To start, the target needs 3-5 representative prompts or scenarios, 3-6 checks answered yes or no, and a deterministic way to inspect behavior or dry-run it. No representative prompts, no stable check — no loop. Hosted evaluation and tracing platforms such as LangSmith, Braintrust, Weave or Promptfoo sit outside this skill; requests for those get routed elsewhere.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill skill-autoresearch -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/skill-autoresearch/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/skill-autoresearch/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill skill-autoresearch -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/skill-autoresearch/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill skill-autoresearch -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/skill-autoresearch/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install akillness/jeo-skills skill-autoresearch
```

2. **Manually: put the files in place**
- File: `.github/skills/skill-autoresearch/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill skill-autoresearch -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/skill-autoresearch
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/skill-autoresearch/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill skill-autoresearch -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/skill-autoresearch/SKILL.md

## When to use it
- decide whether an artifact deserves another round of edits
- lock the evaluation harness before touching anything
- snapshot the baseline and record experiment 0
- make one change and compare it against the baseline on the same harness
- refresh `references/`, `evals/` and discovery wording after a proven change

## Example prompts
- Check whether this repo's `SKILL.md` is worth another ratchet, and write `loop-charter.md`
- Baseline the current skill and log experiment 0
- Tighten the skill's triggers with one change, rerun the same checks, then keep or revert

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

From the same set: [akillness/jeo-skills](https://affpapa.org/en/nevibecode/by/akillness/jeo-skills.md) — 29 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md