# Ship

Land the winning experiment from an evo run as a clean, mergeable change -- open a PR...

- 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 ship -g -a claude-code -y`
Codex: `npx skills add evo-hq/evo --skill ship -g -a codex -y`
Cursor: `npx skills add evo-hq/evo --skill ship -g -a cursor -y`
Gemini CLI: `npx skills add evo-hq/evo --skill ship -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add evo-hq/evo`

## Description

Land the winning experiment from an evo run as a clean, mergeable change -- open a PR when the repo has a remote, otherwise merge into the working branch. Distills the best-scoring experiment down to the minimal diff that reproduces its behaviour, shaped for the qualities a maintainer merges on (scope discipline, test integrity, style adherence), then attaches an advisory mergeability report. Use when the user invokes /evo:ship, asks to land/merge/ship the best result, or wants to turn a finished optimization into a pull request.

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

# Ship

Turn a finished evo run into a change a maintainer would merge.

The optimize loop leaves a tree of committed experiments. The winning worktree
diff is not mergeable as-is: it carries debug prints, search-process churn,
over-broad edits, and sometimes a test that was relaxed to clear a gate. Shipping
is the step that re-derives the *minimal clean change* reproducing the winning
behaviour, lands it the way the repo expects (PR or merge), and reports how
mergeable it is.

Correctness is the floor, not the goal. The score says the behaviour works; this
skill decides whether the *diff* is fit to merge.

## Invocation

```bash
/evo:ship            # ship the auto-selected winner
/evo:ship exp_0042   # ship a specific experiment instead
```

## Stage 1 -- Select the winner

Pick the experiment to ship, then confirm it with the user before touching their
tree.

```bash
evo status    # current best valid score + counts
evo report    # top valid experiments table + score chart
```

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