CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

benchmark-optimization-loop

Convert 'make it faster' requests into a bounded measured optimization loop — baseline first, generate one-hypothesis variants, benchmark each against a correctness gate, and promote the fastest safe variant with reproducible commands. Use when asked to speed something up, try many variants, run recursive optimization, benchmark latency/throughput/cost, or pick the best implementation by repeated measured tests.

Quality

94%

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%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.

A tight, well-structured instruction skill: an efficient body with a numbered loop, explicit validation gates, a concrete variant-tracking table, and a promotion checklist. The only gap is actionability detail — the step of actually benchmarking variants lacks a concrete harness command or repetition guidance.

Suggestions

Add one concrete benchmark-harness example to the Loop or Variant Table section (e.g., a repeat-count loop like 'for i in 1..5: time npm run job -- --batch 500' or a hyperfine invocation) so step 4 'Run variants' is copy-paste executable.

Specify how to enforce 'the same input shape' (step 4) — e.g., a fixed seed or a checked-in fixture path — since differing inputs between baseline and variants would silently invalidate comparisons.

Include a one-line example of how to record the ledger entry for a recursive run, mirroring the Variant Table format, so the ledger requirement is actionable rather than implied.

DimensionReasoningScore

Conciseness

The body is lean with zero padding — no concept explanations Claude already knows, and every section (Required Baseline, Loop, Variant Table, Recursive Search, Promotion Gate) earns its place. It matches the level-5 'every token earns its place' anchor rather than level 4, which requires some over-explanation to trim.

5 / 5

Actionability

Concrete artifacts are present — the Variant Table template with real commands ('npm run job -- --batch 500', 'npm run job -- --workers 8') and a specific Promotion Gate checklist — but the core loop steps remain at the guidance level without a concrete benchmark-harness command or repetition count for actually running variants. This matches level 4 ('mostly executable... concrete code or commands with minor gaps'), not level 5's copy-paste-ready coverage of common cases.

4 / 5

Workflow Clarity

The 8-step numbered loop is clearly sequenced with explicit validation checkpoints (step 5 rejects variants failing correctness/safety/reproducibility; step 8 reruns baseline and winner to confirm the delta) plus explicit stop conditions for recursive search. This batch-operation skill does include validation, so the workflow cap does not apply; it matches the level-5 anchor's explicit validation and feedback-loop criteria.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent) and none are needed: the ~62-line body is compact, well-sectioned with clear headers, and self-contained. Under the simple-skill exception, well-organized sections alone merit the top score; it is not level 4 because there is no content that should be split out or any organization gap.

5 / 5

Total

19

/

20

Passed

Description

96%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: third-person, concise, with a concrete multi-action 'what' and an explicit, natural-phrased 'Use when' trigger clause. The only weakness is that generic benchmark triggers (latency/throughput/cost) create minor overlap risk with a dedicated benchmarking skill.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'baseline first, generate one-hypothesis variants, benchmark each against a correctness gate, and promote the fastest safe variant with reproducible commands' — giving comprehensive coverage of the workflow. It exceeds the level-4 anchor because there are no minor gaps in the action coverage, and each action is concrete rather than generic.

5 / 5

Completeness

It explicitly answers 'what' (a bounded measured optimization loop with named stages) and 'when' via a concrete 'Use when asked to...' clause with specific trigger phrases, matching the level-5 anchor. It is not level 4 because the 'when' is already fully explicit and specific rather than improvable.

5 / 5

Trigger Term Quality

It covers natural user phrasings comprehensively: 'make it faster', 'speed something up', 'try many variants', 'run recursive optimization', 'benchmark latency/throughput/cost', 'pick the best implementation by repeated measured tests'. These are phrases a user would naturally say, with synonyms across the domain; it is above level 4, which only requires 'good' coverage with a few missing terms.

5 / 5

Distinctiveness Conflict Risk

The optimization-loop niche is mostly distinct ('recursive optimization', 'promote the fastest safe variant'), but triggers like 'benchmark latency/throughput' could plausibly claim a generic benchmarking or profiling skill, giving minor overlap with closely related skills. It is not level 5 because that common benchmark trigger carries some non-minimal conflict risk; it is clearly above level 3's 'could still overlap with similar skills' breadth.

4 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

affaan-m/ECC

Path

skills/benchmark-optimization-loop/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.