Agent skill

Autoresearch

by pedronauck in pedronauck/skills

Autonomously optimize any Claude Code skill by running it repeatedly, scoring outputs against binary evals, mutating the prompt, and keeping improvements.

No licenceAuto-check passedAgent Workflows

Install Autoresearch

skills CLI
$ npx skills add pedronauck/skills --skill autoresearch -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pedronauck/skills autoresearch --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pedronauck/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/curated/autoresearch .claude/skills/autoresearch && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
autoresearch
GitHub stars
634
Token cost
~3.7k tokens
SKILL.md length
1,837 words
Files
2
Skills in repo
65
Repo updated
First seen
Licence
None found

At a glance

Autonomously optimize any Claude Code skill by running it repeatedly, scoring outputs against binary evals, mutating the prompt, and keeping improvements.

  • Works in 7 steps: read the skill → build the eval suite → generate the live dashboard → …
  • : optimize this skill
  • SKILL.md covers the core job, before starting: gather context, step 1: read the skill and step 2: build the eval suite, plus 9 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Autoresearch is an agent skill from pedronauck/skills. Autonomously optimize any Claude Code skill by running it repeatedly, scoring outputs against binary evals, mutating the prompt, and keeping improvements. Based on Karpathy's autoresearch methodology. Use when: optimize this skill, improve this skill, run autoresearch on, make this skill better, self-improve skill, benchmark skill, eval my skill, run evals on. Outputs: an improved SKILL.md, a results log, and a changelog of every mutation tried.

Its SKILL.md is about 3.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `eval-guide.md`).

It sits in Agent Workflows, covering Autonomous loops and LLM evaluation. The repository describes itself as: My personal favorite skills.

When your agent uses it

  • : optimize this skill
  • Improve this skill
  • Run autoresearch on
  • Make this skill better

Example prompts

  • “/autoresearch”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. read the skill
  2. build the eval suite
  3. generate the live dashboard
  4. establish baseline
  5. run the experiment loop
  6. write the changelog
  7. deliver results

What it can do on your machine

Read from SKILL.md and the folder at commit 0422940. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json and markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Autoresearch loads about 3.7k tokens when it runs. Until then it costs about 116 tokens; SKILL.md has 1,837 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~116
When it runs · the whole SKILL.md, loaded when a task matches
~3.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 1,837 words (~3,695 tokens).

“Most skills work about 70% of the time. The other 30% you get garbage. The fix isn't to rewrite the skill from scratch. It's to let an agent run it dozens of times, score every output, and tighten the prompt…”

— opening of SKILL.md by pedronauck
name
autoresearch

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in skills/curated/autoresearch of pedronauck/skills.

  • SKILL.md
  • eval-guide.md

Open the folder on GitHubat commit 0422940

Compare with similar skills

Autoresearch next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Autoresearch compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Autoresearch this skillpedronauck/skills634—~3.7kAutomated safety check: PassNone
Continuous Agent Loopaffaan-m/ECC276k5 repos~298Automated safety check: PassMIT
Loop Architectfabricioctelles/skills106—~2.1kAutomated safety check: NotesMIT
Autoresearchbyungjunjang/jangpm-meta-skills120—~6kAutomated safety check: WarnNone
Improving MCP ToolsPostHog/posthog40k—~1.5kAutomated safety check: PassCustom licence
Inngest AgentsAsymmetric-al/core381—~2.6kAutomated safety check: PassAGPL-3.0

Similar skills

  • Patterns for continuous autonomous agent loops with quality gates, evals, and recovery controls.

    276k GitHub starsUsed in 5 repos~298 tokens
    Agent WorkflowsAuto-check passed
  • Loop Architect

    fabricioctelles/skills

    Design well-structured agent loops with best-practice coaching and cross-model review gates before you run them.

    106 GitHub stars~2.1k tokensUpdated 6 days ago
    Agent WorkflowsAuto-check: notes
  • Autoresearch

    byungjunjang/jangpm-meta-skills

    Autonomously optimize a Claude Code skill or agent system by running it repeatedly, scoring outputs against evals, mutating owned artifacts (prompt, references, scripts, agent definitions), and…

    120 GitHub stars~6k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check: warnings
  • Improving MCP Tools

    PostHog/posthog

    Official

    Run an improve-my-MCP campaign: an autoresearch-style loop that measures the MCP agent experience with the eval harness, picks the highest-impact tool problem from production data, makes one bounded…

    40k GitHub stars~1.5k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Inngest Agents

    Asymmetric-al/core

    A skill your agent uses when building durable AI agents or agentic workflows with Inngest and AgentKit, including model calls, tool calls, multi-agent networks, human approval, realtime progress…

    381 GitHub stars~2.6k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Author Skill

    ericrisco/rsc-harness

    A skill your agent uses when authoring a NEW rsc skill or editing an existing one — scoping it to one job, writing the description that decides whether it ever loads, splitting the body into…

    180 GitHub stars~4.3k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed

More from pedronauck/skills

All 65 skills in this repo
  • Deep Review

    pedronauck/skills

    Review branch diffs, working trees, or PRs in depth with defect, polish and cross-contract coverage.

    634 GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • Yc Apply

    pedronauck/skills

    Prepare, review, and package Y Combinator application answers and founder-video notes using the live form and verified founder facts.

    634 GitHub stars~1.3k tokensUpdated 26 days ago
    Auto-check passed
  • Guide technical communication for software developers. An agent skill from pedronauck/skills.

    634 GitHub starsUsed in 3 repos~2.3k tokens
    Auto-check passed
  • Tauri V2

    pedronauck/skills

    Tauri v2+ cross-platform app development with Rust backend. An agent skill from pedronauck/skills.

    634 GitHub starsUsed in 2 repos~4.1k tokens
    Auto-check passed
  • Hormozi Ad Factory

    pedronauck/skills

    Generates 150-750+ ad variations using Alex Hormozi's combinatorial Hook x Meat x CTA framework.

    634 GitHub stars~2.1k tokensUpdated 26 days ago
    Auto-check passed
  • Yt Master

    pedronauck/skills

    Plans and improves YouTube ideas, titles, thumbnail concepts, scripts, retention, channel strategy, and metric-based diagnosis.

    634 GitHub stars~736 tokensUpdated 26 days ago
    Auto-check passed

Categories

Questions about Autoresearch

What does Autoresearch do?

Autonomously optimize any Claude Code skill by running it repeatedly, scoring outputs against binary evals, mutating the prompt, and keeping improvements. Autoresearch is an agent skill from pedronauck/skills. Autonomously optimize any Claude Code skill by running it repeatedly, scoring outputs against binary evals, mutating the prompt, and keeping improvements.

When should I use Autoresearch?

Autoresearch fits situations like: : optimize this skill; improve this skill; run autoresearch on; make this skill better.

How do I install Autoresearch in Claude Code?

Run `npx skills add pedronauck/skills --skill autoresearch -a claude-code`. Or copy the skill folder (skills/curated/autoresearch in pedronauck/skills) into .claude/skills/autoresearch in your project. Claude Code loads it when a task matches its description.

How do I install Autoresearch in Codex?

Run `npx skills add pedronauck/skills --skill autoresearch -a codex`. Or copy the skill folder (skills/curated/autoresearch in pedronauck/skills) into .agents/skills/autoresearch in your project. Codex loads it when a task matches its description.

Can I use Autoresearch in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pedronauck/skills --skill autoresearch -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/autoresearch, .gemini/skills/autoresearch, .github/skills/autoresearch and .opencode/skills/autoresearch in your project.

What does Autoresearch need to run?

SKILL.md names no scripts, command-line tools or credentials: Autoresearch is instructions for the agent only.

Does Autoresearch access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Autoresearch safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Autoresearch use?

No licence was found for Autoresearch or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Autoresearch use?

About 3.7k tokens (SKILL.md is roughly 15k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Autoresearch?

Skills that share tags, products or a category with Autoresearch: Continuous Agent Loop (affaan-m/ECC, 276k stars), Loop Architect (fabricioctelles/skills, 106 stars), Autoresearch (byungjunjang/jangpm-meta-skills, 120 stars) and Improving MCP Tools (PostHog/posthog, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Autoresearch?

pedronauck (a GitHub user) maintains it in pedronauck/skills, which has 634 GitHub stars. The repository holds 65 skills in this directory. The repository was last updated on September 14, 2026.

Source: pedronauck/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.