Skip to main content
skill CX Codex

skill-autoresearch — Claude Code skill: improve SKILL.md with evals

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add akillness/jeo-skills --skill skill-autoresearch -a claude-code
Open on GitHub

What skill-autoresearch 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.

What it helps with

  • 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 for the agent

  • 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

How to install skill-autoresearch

1Skills CLI (Vercel)

npx skills add akillness/jeo-skills --skill skill-autoresearch -a claude-code

2Manually: put the files in place

~/.claude/skills/skill-autoresearch/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/skill-autoresearch/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about skill-autoresearch

How do I install skill-autoresearch in Claude Code?

Run npx skills add akillness/jeo-skills --skill skill-autoresearch -a claude-code. The skill file lands at ~/.claude/skills/skill-autoresearch/SKILL.md.

What does skill-autoresearch do?

It improves a reusable repo artifact against a frozen harness: baseline, one change, rerun, then a keep-or-revert call. The run history is appended and stays in git.

How is it different from autoresearch or hosted eval platforms?

It works locally inside the repo and targets markdown artifacts. GPU experiments and platforms like LangSmith, Braintrust, Weave or Promptfoo are out of scope and get routed away.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set29

sprint-retrospective Runs a sprint or milestone retrospective and turns it into a few owned actions instead of another template ritual. CX Codex +1 364installs debugging A skill that walks the agent through a reproduce → isolate → verify loop for concrete bugs, regressions and flaky failures. Useful once you already have a failing test or request. CX Codex +1 361installs git-submodule A skill that first asks whether a submodule is the right boundary, then walks you through one safe workflow. Useful when your project pulls in outside code through .gitmodules. CX Codex +1 360installs environment-setup A skill for app configuration: which values belong in .env, what gets committed, how to validate required variables, and where secrets stop being your problem. CX Codex +1 353installs system-environment-setup A skill that makes a repo runnable on any machine: pinned runtimes, local services, containers, bootstrap scripts and setup diagnosis. CX Codex +1 351installs npm-git-install Picks a safe delivery path for a Node package coming from a branch, commit, fork or private repo. Useful when the question is whether to pull from Git at all. CX Codex +1 350installs react-grab This skill lets an agent pull context for a React element you pick in a live browser: component name, file, line and HTML. Useful when a fix has to match the real DOM. CX Codex +1 344installs bmad Reads your current project state and names the next BMAD artifact or gate. Useful when you are stuck after idea notes, a PRD or an architecture draft. CX Codex +1 334installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor