CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bun-runtime

Bun as runtime, package manager, bundler, and test runner. When to choose Bun vs Node, migration notes, and Vercel support.

62

Quality

78%

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 ./skills/bun-runtime/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 content is highly actionable with executable commands and complete code examples covering the common cases, and the Bun-vs-Node decision guidance is clearly structured. Its weaknesses are density and version coupling: long single-paragraph command catalogs inline in SKILL.md and Bun 1.4-specific details distributed throughout rather than split into reference files. Splitting the pm/CI detail into references and trimming restated framing would raise both conciseness and progressive disclosure.

Suggestions

Move the package-manager/workspace/audit command catalog and the CI test-flag details (bun test --changed/--isolate/--parallel/--shard/--timings) into one-level-deep reference files (e.g. references/pm.md, references/testing.md), keeping only the most common commands inline.

Trim the opening restatement of the description and convert the long prose command paragraphs into bulleted command lists so each token carries new information.

Consolidate the scattered Bun 1.4 version mentions into the single version-baseline note at the top, isolating version-sensitive flags there so the core guidance stays stable.

DimensionReasoningScore

Conciseness

The body is mostly efficient and avoids explaining concepts Claude already knows, but it could be tightened: the opening line "Bun is a fast all-in-one JavaScript runtime and toolkit" restates the description, and the package/workspace command catalog and CI test-flag passage each run as a single dense paragraph that would be leaner as bullets. Time-sensitive version details ("guidance below targets Bun 1.4.x", repeated 1.4 references) are woven throughout rather than isolated in a versioned/deprecated section, which the guidelines penalize.

3 / 5

Actionability

Guidance is fully executable and copy-paste ready: concrete commands ("bun install", "bun add <pkg>", "bun test --parallel --timings=./test-timings.json --update-timings", "bun install --frozen-lockfile"), a complete bun:test file, working Bun.file/Bun.serve code, and an exact Vercel config ("Set `bunVersion: \"1.4.x\"` in `vercel.json`"). Examples cover the common run/install/env/test/serve cases.

5 / 5

Workflow Clarity

The decision workflow is clear and sequenced: "Prefer Bun for" / "Prefer Node for" criteria, then migration steps ("Replace `node script.js` with `bun run script.js`"), then commands and deployment. Explicit checks exist ("Check the actual version with `bun --version`", "verify before depending on it in production", "Check the installed version's help"), but they are prose cautions rather than structured checkpoints, so it sits at 4 rather than 5. No destructive or batch operations are involved, so the cap-at-3 rule does not apply.

4 / 5

Progressive Disclosure

The body is well-organized into clear sections (When to Use, How It Works, Examples, Best Practices) with external links to authoritative docs (bun.com/docs, Vercel's Bun runtime docs), and no bundle files exist so nothing is misfiled. It falls short of 5 because the inline package-manager/audit/workspace command catalog and the CI test-flag reference material are exactly the kind of detail that belongs in a one-level-deep reference file, and the skill is ~95 lines rather than a compact overview.

4 / 5

Total

16

/

20

Passed

Description

75%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 is specific, distinct, and answers both what the skill covers and when it applies, though the when is expressed as topics ('When to choose Bun vs Node') rather than user-facing trigger phrases. It is concise without vagueness or buzzwords. A few natural trigger terms (bun install, bun test, JS/TS) would strengthen it.

DimensionReasoningScore

Specificity

"Bun as runtime, package manager, bundler, and test runner" plus "When to choose Bun vs Node, migration notes, and Vercel support" lists several specific capabilities with only minor gaps. It stops short of the score-5 anchor because these are role nouns rather than concrete actions (no verb forms like 'runs scripts', 'installs packages', 'bundles apps'), but it covers more ground than the 1–2 concrete actions of the score-3 anchor.

4 / 5

Completeness

The 'what' is clear ("Bun as runtime, package manager, bundler, and test runner") and a 'when' is explicitly present ("When to choose Bun vs Node"), so it is not capped at 3 for a missing when-clause. However, the when is topic-framed rather than concrete trigger phrases ('Use when the user mentions bun.lock or bun test'), matching the both-present-but-could-be-more-explicit anchor at 4 instead of 5.

4 / 5

Trigger Term Quality

Natural terms users would actually say are present: "Bun", "Bun vs Node", "migration", "Vercel". A few common variations are missing (e.g. 'bun install', 'bun test', 'JavaScript/TypeScript', 'bun.lock'), so it fits the good-but-not-comprehensive anchor rather than the score-5 synonym-and-extension coverage anchor.

4 / 5

Distinctiveness Conflict Risk

"Bun" names a specific tool with distinct triggers, giving a clear niche. But "When to choose Bun vs Node" and "Vercel support" create minor overlap risk with closely related Node and Vercel deployment skills, matching 'mostly distinct; minor overlap risk' (4) rather than the minimal-conflict anchor at 5.

4 / 5

Total

16

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

affaan-m/ECC

Path

skills/bun-runtime/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.