CtrlK
BlogDocsLog inGet started
Tessl Logo

optimize

Drive structured autoresearch iteration after evo:discover and the baseline commit. Use when the user invokes /evo:optimize or asks to try ideas, try variants, run experiments, use available GPUs, improve the current best/frontier, continue an evo search, or compare candidate changes in an evo workspace. The orchestrator plans and spawns optimization subagents; candidate edits/runs belong to those subagents. Width is set via subagents=N (1 for serial workloads, larger for parallel); the loop's structural value applies at any width.

71

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

77%Weight 40%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is exceptionally actionable and the multi-round loop is sequenced with strong validation checkpoints, but it is let down by verbosity/repetition and a monolithic structure that ships no bundle files of its own despite deferring to external references.

Suggestions

Tighten the body: collapse the repeated re-explanations of the candidate-work-delegation, resource-cap, and bounded-run invariants into a single 'Invariants' block, and trim the 'Plain-language trigger' section which duplicates the frontmatter description.

Split the bulkier inline sections into bundle reference files under this skill (e.g. references/host-spawn.md for the per-host spawn table, references/backends.md for pool/remote-backend mode, references/ideator-flow.md for steps 6b–6c) and link to them one level deep from SKILL.md.

Move the per-host spawn-command catalogue (claude-code/codex/hermes/openclaw/opencode/pi/cursor/kimi) out of the main loop narrative into a referenced table so Step 5 reads as protocol rather than a host-compatibility manual.

DimensionReasoningScore

Conciseness

The body is ~52KB / ~590 lines and, while it does not explain basic concepts Claude already knows, it is padded with heavy repetition and over-emphasis — the 'Plain-language trigger' section duplicates the description, and invariants (candidate-work delegation, resource-cap, bounded-run) are re-explained at length multiple times. It is mostly domain-specific protocol that earns its place, but a great deal could be tightened, so it sits above the verbose anchor-1 and below the lean anchor-3.

2 / 3

Actionability

Highly actionable throughout: exact CLI commands (`evo scratchpad`, `evo frontier`, `evo prune <id> --exhausted --reason "..."`, `evo wait --for ... --timeout 60m`), a verbatim scan-subagent prompt, a mandatory verbatim opening sentence for subagent prompts, and per-host spawn commands — copy-paste ready rather than abstract.

3 / 3

Workflow Clarity

The Loop is a clearly sequenced Step 0 → 8 process with explicit validation checkpoints — mandatory project.md read (Step 0), host migration (Step 0.1), diversity check 'before spawning', verifier pre/post hooks, 'Verify every pattern before emitting it', and a step-5 self-check that spawned count equals subagents=N. Feedback loops for batch/destructive operations (prune, remote recovery, epoch reset) are present, so it is not capped at 2.

3 / 3

Progressive Disclosure

It does signal one-level-deep external references well (sizing-the-round.md, evo-wait.md, cli-quick-reference.md, provider-matrix.md, ideator.md) and deliberately avoids inlining the full CLI map / surface tree, which keeps it above anchor-1. But no bundle files ship with this skill and the SKILL.md itself is a 52KB monolith with large inline blocks (per-host spawn tables, pool/remote mode docs, the full ideator subsection) that should be split out, so it does not meet 'content appropriately split'.

2 / 3

Total

10

/

12

Passed

Description

100%Weight 40%Scale 1-3

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is strong: third-person voice, explicit 'Use when' triggers with natural user phrasings, concrete orchestrator behaviors, and a clearly distinct evo-specific niche. All four dimensions land at the top of the scale.

DimensionReasoningScore

Specificity

Lists multiple concrete behaviors — 'plans and spawns optimization subagents', 'candidate edits/runs belong to those subagents', 'Width is set via subagents=N' — rather than vague language. The opening 'structured autoresearch iteration' is slightly abstract but it is backed by several specific concrete actions, matching the anchor-3 example.

3 / 3

Completeness

Explicitly answers both what ('Drive structured autoresearch iteration after evo:discover ... orchestrator plans and spawns optimization subagents') and when ('Use when the user invokes /evo:optimize or asks to try ideas, try variants, run experiments ...'), with an explicit 'Use when' trigger clause.

3 / 3

Trigger Term Quality

Covers natural phrasings a user would actually say — 'try ideas', 'try variants', 'run experiments', 'use available GPUs', 'improve the current best/frontier', 'continue an evo search', 'compare candidate changes' — plus the /evo:optimize command, giving good coverage of natural trigger terms.

3 / 3

Distinctiveness Conflict Risk

The trigger is tightly scoped to an initialized evo workspace and the post-/evo:discover phase, with evo-specific terms ('evo workspace', '/evo:optimize', 'after evo:discover and the baseline commit'), making it a clear niche unlikely to fire for unrelated skills.

3 / 3

Total

12

/

12

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (592 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

13

/

16

Passed

Repository
evo-hq/evo
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.