CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

optimization-mission-playbook

Domain playbook for optimization missions — any task whose goal is to move a metric: performance, latency, throughput, memory, cost, score, quality, compression, ranking, solver, model/eval, and similar metric-improvement work. Defines how to think about and run an optimization mission: establishing the ground truth, trusting the measurement, profiling to the dominant cost, estimating the ceiling, generating and pruning disposable hypotheses, exploring cheaply before verifying expensively, guarding against metric gaming and overfitting, reasoning about correctness and trade-offs, and stopping on evidence.

Quality

79%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/optimization-mission-playbook/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

62%Weight 40%Scale 1-5

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

The workflow is exceptionally clear and the runtime method is highly actionable, but the document is noticeably verbose — repeating its own guidance across sections and explaining general optimization knowledge Claude already has — and makes no use of progressive disclosure despite a length that clearly warrants it. The strategy half is strong content in the wrong place.

Suggestions

Move the field-list specifications (optimization method fields, ledger fields, checker report fields) and the Pre-Submit Checklist into one-level-deep reference files (e.g. references/method-fields.md, references/checklist.md), keeping SKILL.md as an overview; this alone would remove ~150 lines of inline specification and raise progressive disclosure.

Deduplicate the noise/MDE and case-set guidance, which currently appears in §1, in the metric-protocol/correctness-protocol definitions, and again in the checklist — state it once and cross-reference.

Trim explanations of concepts Claude already knows (Amdahl's law arithmetic, tail percentiles vs mean, warmup, Goodhart) down to the mission-specific framing — e.g. keep 'the ruler is read-only' and the three-way conflation, drop the textbook derivations.

DimensionReasoningScore

Conciseness

The ~680-line body re-derives concepts Claude already knows (Amdahl's law, tail percentiles vs mean, warmup, Goodhart's law) and duplicates its own material — noise/MDE guidance appears in §1, the metric protocol fields, and the checklist; case-set design appears in both §1 and Investigation; the Pre-Submit Checklist restates the Investigation section nearly field-for-field. This is several padded/duplicated sections, matching anchor 2 rather than the occasional tightening of anchor 3.

2 / 5

Actionability

The method half is concretely executable: exact task YAML with ids, skills, and bodies; explicit optimization-method and ledger field lists; the exact call 'end_node(done=True, report=..., request_attention=True)'; and enumerated dispositions ('accept | reject | keep_as_evidence | rerun | inspect'). It stays at 4 rather than 5 because the strategy half is necessarily prose and worker guidance defers to unspecified project-authored skills.

4 / 5

Workflow Clarity

Multi-step processes are explicitly sequenced with validation checkpoints and error-recovery loops: The Loop (steps 1–7), Operating Order for PLAN and DECIDE wakes, acceptance before/after lists, the four disqualifying win questions of §6, rerun triggers 'when the delta is close to noise', and a patch policy mapping each anti-pattern to a fix. Validation is pervasive, so no destructive/batch cap applies and the 5 anchor is the best fit.

5 / 5

Progressive Disclosure

No bundle files exist — the strategy prose, metric-family table, field-list specifications, and checklists are all inlined in a single very long file that clearly merits splitting into references. Good internal headers keep it above the 'minimal structure' of anchor 2, but zero file separation for a document of this length caps it at 3.

3 / 5

Total

14

/

20

Passed

Description

88%Weight 40%Scale 1-5

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

A strong description: it names the domain, enumerates comprehensive concrete method actions, and gives explicit trigger guidance covering many metric families. Minor gaps in natural phrasing synonyms and slight breadth-induced overlap risk keep trigger quality and distinctiveness at 4.

DimensionReasoningScore

Specificity

The description lists nine concrete method actions — 'establishing the ground truth, trusting the measurement, profiling to the dominant cost, estimating the ceiling, generating and pruning disposable hypotheses, exploring cheaply before verifying expensively, guarding against metric gaming and overfitting', plus 'stopping on evidence' — comprehensive coverage of the mission lifecycle, matching the top anchor rather than the 'minor gaps' of 4.

5 / 5

Completeness

It clearly answers 'what' ('Domain playbook... Defines how to think about and run an optimization mission') and 'when' with explicit trigger guidance ('any task whose goal is to move a metric' followed by concrete trigger phrases), which is equivalent to a 'Use when...' clause; not 4, because the 'when' is explicit and concrete rather than improvable.

5 / 5

Trigger Term Quality

'performance, latency, throughput, memory, cost, score, quality, compression, ranking, solver, model/eval, and similar metric-improvement work' gives good natural-keyword coverage across metric families, but common user phrasings like 'faster', 'speed up', 'benchmark', and 'tuning' are absent, so it falls short of the comprehensive synonym coverage of the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The metric-moving mission framing is a clear niche with distinct triggers, but broad terms like 'quality', 'cost', and 'memory' leave minor overlap risk with single-domain skills (cost reduction, memory profiling); not 5 because conflict risk is more than minimal.

4 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

Total

15

/

16

Passed

Repository

jomi-se/bookhand

Path

.agents/skills/optimization-mission-playbook/SKILL.md

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.