CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

benchmark

Measure and repair Plate/Plite performance, or review a performance design before running its applicable benchmark lanes. Use before writing, reviewing, running, rerunning, checking, skipping or deferring a performance gate, including a plan's scale gate, before writing a benchmark script, before explaining a benchmark result or failure, and when a review or panel finds a latency or scaling cost.

Quality

75%

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/benchmark/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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 dense, domain-specific rulebook with strong validation discipline (known-bad controls, noise rules, rerun contracts) but written in long, repetitive prose that buries its executable commands. The bundle exists, yet the body's script references resolve outside it and one reference file is orphaned, so navigation does not exploit the bundle layout.

Suggestions

Tighten the prose: remove the duplicated 'before creating a plan, running a benchmark or changing runtime code' read-directives and the restated defer/gate rule, and split the multi-clause noise/planted-arm rules into a short table or bullet list.

Point script invocations at the bundle's own files (e.g. scripts/paired-timing.mjs instead of .agents/rules/benchmark/scripts/paired-timing.mjs) and reference references/autoresearch.md from the body so every bundle file is discoverable.

Move the ~100-line Pre-Acceptance Architecture Probe law into a references/ file, keeping a short step summary inline, so the probe's executable commands (proof-worktree.mjs, paired-timing.mjs, build-app-if-stale.mjs) stand out in SKILL.md.

DimensionReasoningScore

Conciseness

Almost every line carries project-specific rules rather than concepts Claude already knows, but the prose could be tightened substantially: the instruction to read the playbook "before creating a plan, running a benchmark or changing runtime code" appears twice nearly verbatim (lines 19-20 and 26-27), the defer/gate rule is restated in step 5 and again in the following paragraph, and multi-clause run-ons like the cohort-noise rule ("A cohort's noise is the larger of its same-code gap and the furthest any pair ... because a same-code arm divides by the same base runs ...") demand several re-reads. Matches mostly-efficient-but-could-be-tightened, not noticeably padded with unnecessary explanations (2).

3 / 5

Actionability

There are genuinely concrete commands scattered throughout ("node tooling/scripts/proof-worktree.mjs", "node .agents/rules/benchmark/scripts/paired-timing.mjs", "node tooling/scripts/review-ledger.mjs lookup <scope>", "pnpm bench:editor:install", "--reporter=verbose --silent=false"), but the central Pre-Acceptance Probe workflow is dense policy law ("Reuse an honest existing budget when one exists", "Size each line relative to the baseline and above the timer resolution") whose executable mechanics are delegated to a playbook and scripts outside this bundle. Some concrete guidance, incomplete within the body — matching anchor 3 rather than mostly-executable anchor 4.

3 / 5

Workflow Clarity

The probe is a numbered 5-step sequence with abundant validation checkpoints and feedback loops: a planted-slowdown control the budget line must reject, a known-bad input that "must fail with the probe's own assertion text", inconclusive results branching to defer/gate, and conclusive misses sending the target "back to `architect` at once". Not a 5 because the full end-to-end workflow is interleaved across external cross-references (the perf-issue playbook, `pstack:benchmark-checklist`, `verify`'s command recipes) that a reader must assemble themselves, leaving minor sequence gaps in the body alone.

4 / 5

Progressive Disclosure

The two key references are clearly signaled with when-to-read guidance ("For `review <scope-or-plan>`, read the full [performance review method](./references/performance-review.md)"; "Read [methodology.md](./references/methodology.md) completely before creating a plan..."), but the structure has real gaps against the actual bundle: `references/autoresearch.md` is never mentioned, the ~100-line Pre-Acceptance Probe law is inlined where a reference would fit, and script paths point outside the bundle (`.agents/rules/benchmark/scripts/paired-timing.mjs`, `.agents/rules/benchmark/scripts/benchmark-contract.test.mjs`) instead of the colocated `scripts/` files. Between anchor 3 and anchor 4; the orphaned file, path mismatches, and heavy inline section pull it to 3.

3 / 5

Total

13

/

20

Passed

Description

87%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: concrete domain-specific actions, an explicit and thorough Use-when clause, and clear niche boundaries. Main residual weakness is a trigger vocabulary limited to the project's own gate/benchmark jargon while missing everyday performance words users might say.

DimensionReasoningScore

Specificity

Names a precise domain ("Plate/Plite performance") and three concrete actions — "Measure and repair ... performance, or review a performance design before running its applicable benchmark lanes" — matching the several-specific-actions anchor. Not a 5 because coverage of capabilities is narrow (no mention of comparison, diagnosis, or harness repair work the body actually does); not a 3 because it goes beyond 1-2 generic actions with the lane/gate specifics.

4 / 5

Completeness

Explicitly answers what ("Measure and repair Plate/Plite performance, or review a performance design before running its applicable benchmark lanes") and when, with an unusually thorough trigger enumeration ("Use before writing, reviewing, running, rerunning, checking, skipping or deferring a performance gate ... before writing a benchmark script, before explaining a benchmark result or failure, and when a review or panel finds a latency or scaling cost"). Matches the anchor for both what and when with concrete trigger phrases; anchor 4's caveat (when could be more explicit) does not apply.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "performance", "benchmark", "latency", "scaling cost", "performance gate", "benchmark script", "benchmark result or failure" are phrases a developer in this repo would say. Not a 5 because common synonyms like slow, speed, regression, or profiling are missing, and some trigger phrasing ("a plan's scale gate", "a review or panel finds") is internal process jargon rather than user-natural language.

4 / 5

Distinctiveness Conflict Risk

The Plate/Plite product names and performance-gate/benchmark-lane vocabulary define a clear niche with distinct triggers, so minimal conflict risk with other skills. It is not a 4 because no closely related skill in a typical bundle would claim this same product-specific measurement/gate territory.

5 / 5

Total

18

/

20

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.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository

udecode/plate

Path

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