CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

verify

Verify a Bun runtime change by driving the debug binary end-to-end.

Quality

81%

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

100%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 body is an exemplar of a lean, high-signal skill file: dense with non-obvious project-specific gotchas, executable commands each paired with a concrete fix, an explicit validate-then-rebuild feedback loop guarding the most dangerous failure mode (stale binary), and clean section structure at minimal length. No bundle files exist, and none are needed at this size.

DimensionReasoningScore

Conciseness

Every line carries non-obvious, project-specific knowledge Claude would not have ("the build succeeds while the binary still runs the OLD JS", "a second one blocks on the build lock and looks like a runtime hang"). There is no padding and no explanation of concepts Claude already knows; nothing to trim. Not 4 — no over-explanation exists anywhere in the body.

5 / 5

Actionability

Fully executable, copy-paste-ready commands throughout: `bun bd --version`, `bun bd -e '<repro>'`, `PATH="$HOME/.cargo/bin:$PATH"`, `touch src/jsc/bindings/InternalModuleRegistry.cpp`, `./build/debug/bun-debug <file>`, `node -e '<same repro>'` — each gotcha paired with its specific fix. Common cases (JS-visible changes, workers/subprocesses, node:cluster, Node-compat) are all covered. Not 4 — no gaps in concrete guidance.

5 / 5

Workflow Clarity

The flow is unambiguous — build, then drive — and the first gotcha supplies an explicit validation checkpoint with a feedback loop: "Gate on the binary, not the build: ask the binary you just built — `bun bd -e 'console.log(<Class>.toString().includes("<new-id>"))'`... If false, `touch src/jsc/bindings/InternalModuleRegistry.cpp` and rebuild." The Gotchas section doubles as a checklist of pitfalls. Not 4 — validation and recovery steps are explicit, not merely present.

5 / 5

Progressive Disclosure

This is a single-task skill under 50 lines with no bundle files (references/, scripts/, assets/ are absent), so everything appropriately lives inline in three well-organized sections (Build, Drive, Gotchas). Per the rubric's simple-skill note, well-organized sections alone earn a 5 here. Not 4 — no content is misplaced or in need of splitting.

5 / 5

Total

20

/

20

Passed

Description

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

The description states a clear, concrete, third-person purpose with a distinct niche, but provides no explicit trigger guidance (no "Use when..." clause) and misses natural synonyms users would say. This caps completeness at 3 and limits trigger coverage even though the niche itself is well-defined.

Suggestions

Append an explicit trigger clause, e.g. "Use when verifying or testing a change to Bun's runtime source (C++ or bundled JS) before reporting results."

Add natural synonyms users would say — "test", "reproduce", "smoke-test" — so the skill triggers for requests like "test my Bun change" or "reproduce this bug locally".

Name the key command or artifact (e.g. "bun bd", "build/debug/bun-debug") in the description to strengthen both keyword coverage and specificity.

DimensionReasoningScore

Specificity

"Verify a Bun runtime change" names the domain and "by driving the debug binary end-to-end" gives a concrete method, but only one action is described rather than several. Not 2 (the action and method are concrete, not generic like "Processes PDF files"); not 4 (no list of several specific actions such as build, run repro, cross-check).

3 / 5

Completeness

The "what" is clear ("Verify a Bun runtime change by driving the debug binary end-to-end") but there is no "Use when..." clause or equivalent explicit trigger guidance, so completeness is capped at 3. It fits anchor 3 exactly: clear what, when missing or only weakly implied.

3 / 5

Trigger Term Quality

Relevant keywords are present ("Verify", "Bun runtime change", "debug binary"), but common variations users would actually say — "test", "reproduce", "check my change" — are missing. Not 2 (the terms are domain-relevant, not generic); not 4 (natural synonyms and artifacts like `bun-debug` or `bun bd` are absent).

3 / 5

Distinctiveness Conflict Risk

"Bun runtime change" and "debug binary" carve a clear niche with minimal overlap risk among plausible skills. Not 5 because the bare verb "Verify" is generic and could weakly match unrelated verification/testing skills; not 3 because the domain terms are far more specific than "Works with document files".

4 / 5

Total

13

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

oven-sh/bun

Path

.claude/skills/verify/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.