🤖
AI EngineeringPython

Evo Subagent Protocol

by evo-hq

Evo Subagent Protocol is an AI Engineering skill for Claude Code, published by evo-hq in evo.

1.4K stars105 forkson evo-hq/evoAdded 2026/08/19+1% in starsRepository updated 2026/07/17
agent-skillsautonomous-agentsautoresearchclaude-codecode-optimizationcodexevolutionary-algorithmsllm-agents
Install in seconds
Install Evo Subagent Protocol
Copy Evo Subagent Protocol into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/evo-hq/evo/tree/main/plugins/evo/skills/subagent ~/.claude/skills/subagent

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/evo-hq/evo.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
plugins/evo/skills/subagent/SKILL.md in evo-hq/evo
Installs to
~/.claude/skills/subagent
Collection
One of 8 skills cataloged from this repository
Category
AI Engineering2451 skills

What Evo Subagent Protocol does

Evo Subagent Protocol defines the brief shape and execution loop that evo optimization subagents follow when dispatched from /optimize. Orchestrators use it to write valid briefs and debug subagent behavior; subagents use it to drive required verifier checks and read-edit-run iteration.

Evo Subagent Protocol is cataloged under AI Engineering on DirSkills. Evo Subagent Protocol comes from a repository tagged agent-skills, autonomous-agents, autoresearch, claude-code and code-optimization.

Documentation

README

Evo Subagent Protocol

Orchestrators reading for context: this is the protocol your dispatched subagents follow. You don't act on it yourself -- write briefs that satisfy the four required fields described below, and rely on each spawned subagent to drive the loop on its end. Stop reading at "Host conventions" if you only need the brief shape; the rest is for the subagent.

Evo surface -- subagent perspective

What you can pull/dispatch/read as a subagent. Each line is a triggering condition.

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Evo Subagent Protocol

  • What else does evo-hq publish alongside Evo Subagent Protocol?

    Evo Subagent Protocol is one of 8 skills that DirSkills catalogs from evo-hq/evo, the repository it ships in. Its siblings there include Discover, Evo Report and Finetuning. Each one is a separate skill with its own page in this directory, installs the same way Evo Subagent Protocol does, and is maintained by evo-hq in that same repository. The rest of the collection is listed on the evo-hq/evo page.

  • How does Evo Subagent Protocol compare to other AI Engineering skills?

    Evo Subagent Protocol ranks #1068 by stars among the 2451 AI Engineering skills in this catalog. The most-starred ones next to it are Architecture Decision Records, AI-First Engineering and Agentic OS. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Evo Subagent Protocol against them. Open each page to compare what they document and how they install.

More from evo-hq/evo

Evo Subagent Protocol is one of 8 skills cataloged on DirSkills from evo-hq/evo.

See all 8 skills
🔍
2w ago

Discover

Discover initializes an evo workspace for the current repository by exploring the codebase, proposing optimization dimensions, constructing a benchmark, and running a baseline experiment. Use it when starting a new evo run or instrumenting a project for autonomous optimization.
AI Engineering
1.4K105
📊
2w ago

Evo Report

Evo Report provides read-only reports from recorded evo workspace state, including score charts, frontier candidates, and status summaries. Use it when someone asks what happened overnight, what improved, or wants a quick chart without opening the dashboard.
Data
1.4K105
🎯
2w ago

Finetuning

Finetuning selects or diagnoses a training move—SFT, LoRA, DPO/KTO/ORPO, RFT, GRPO/PPO/RLOO, RLHF—based on reward shape and literature, then gates runs with smoke tests, early stopping, and diagnostics. Use it when fine-tuning, post-training, reward design, or weight updates come up.
AI Engineering
1.4K105
⚙️
2w ago

Infra Setup

Infra Setup guides switching the evo backend between local worktrees, pool slots, and remote providers like Modal, E2B, or SSH. It checks prerequisites, verifies auth, and shows the exact config commands so experiments run on the intended infrastructure.
DevOps
1.4K105
🧪
2w ago

Optimize

Optimize drives structured autoresearch iteration after evo:discover and the baseline commit, orchestrating subagents to run experiments and improve the current best frontier. Use it when the user invokes /evo:optimize or asks to try ideas, variants, or continue an evo search.
AI Engineering
1.4K105
🧬
2w ago

Optimize

Optimize runs the evo optimization loop with parallel subagents until interrupted or the stall limit is reached. Use it after a baseline experiment is committed to evolve code changes against benchmarks and prune dead branches.
AI Engineering
1.4K105