# Subagent

Protocol that evo optimization subagents follow when dispatched from /optimize.

- Repository: https://github.com/evo-hq/evo (1491 stars)
- Category: Testing
- License: Apache-2.0
- Last updated: 2026-10-05
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add evo-hq/evo --skill subagent -g -a claude-code -y`
Codex: `npx skills add evo-hq/evo --skill subagent -g -a codex -y`
Cursor: `npx skills add evo-hq/evo --skill subagent -g -a cursor -y`
Gemini CLI: `npx skills add evo-hq/evo --skill subagent -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add evo-hq/evo`

## Description

Protocol that evo optimization subagents follow when dispatched from /optimize. Auto-loaded by spawned subagents via their host's skill loader. The orchestrator may also invoke this skill to understand the brief shape its dispatched subagents expect + what they're required to emit -- useful when writing briefs or debugging a subagent's behavior.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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.

```
skills you may pull (Skill tool)
└── evo:finetuning     before writing or changing any train.py -- technique
                       choice, training recipe, observability, retry discipline.

subagents you dispatch (Task tool, subagent_type=...)
├── evo:verifier              MANDATORY pre AND post every `evo run`.
│                             Pre: static analysis before the experiment runs
│                                  (block on failure -- fix and retry).
│                             Post: result-validity audit after it commits.
└── evo:benchmark-reviewer    POST-COMMIT only, mode=review-experiment --
                              per-task failure classification + annotations.
                              Skip on evaluated/discarded/failed outcomes.

The rest: https://github.com/evo-hq/evo/blob/HEAD/plugins/evo/npm/skills/subagent/SKILL.md