CtrlK
BlogDocsLog inGet started
Tessl Logo

bun-runtime

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

63

Quality

76%

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

Quality

Content

86%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 lean, highly actionable reference: every section is built from executable commands and concrete decision rules, and the structure is appropriately self-contained with no bundle files needed. The only meaningful gap is a missing post-migration verification step in the Node-to-Bun workflow.

DimensionReasoningScore

Conciseness

Efficient and dense with commands, but a few tokens could be trimmed ("implemented in Zig" trivia, and the generic "Keep dependencies up to date; Bun and the ecosystem evolve quickly") — anchor 4's "minor instances of over-explanation". Not 5 because those few tokens don't earn their place.

4 / 5

Actionability

Fully executable, copy-paste-ready commands and code covering the common cases: `bun install --frozen-lockfile`, `bun run --env-file=.env dev`, `bun test --watch`, `Bun.file`/`Bun.serve` snippets, and `bun build ./src/index.ts --outdir=dist` — matches anchor 5 exactly. Not 4 because there are no gaps; the examples cover install, run, env, test, and server API.

5 / 5

Workflow Clarity

The migration sequence is concrete ("Replace `node script.js` with `bun run script.js`… Run `bun install` in place of `npm install`") with explicit decision rules (Prefer Bun / Prefer Node lists), but there is no verification checkpoint after migration (e.g. "run bun test to confirm parity") — anchor 4's "minor validation gaps". Not 5 because explicit validation steps are absent; not 3 because the sequence and decision points are clear, and there are no destructive or batch operations that would trigger the cap.

4 / 5

Progressive Disclosure

The skill is self-contained with no external references needed and clean, well-organized sections (When to Use / How It Works / Examples / Best Practices). Per the judging guideline, a short skill with no need for external references scores 5 on well-organized sections alone. Not 4 because there is no content that clearly belongs in a separate bundle file.

5 / 5

Total

18

/

20

Passed

Description

66%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 solid, honest description with good keyword coverage and a clear niche, but it lacks an explicit 'Use when...' trigger clause, which caps its completeness at 3. Adding explicit usage triggers and natural command/extension keywords would lift both completeness and trigger quality.

Suggestions

Add an explicit trigger clause, e.g. "Use when adopting Bun, migrating a Node project to Bun, writing or debugging bun test suites, or configuring the Bun runtime on Vercel."

Include natural command and ecosystem keywords users actually say — "bun install", "bun test", "bun.lock", "npm", "JavaScript/TypeScript" — to improve trigger term coverage.

Phrase capabilities as concrete actions rather than role nouns (e.g. "Install dependencies with bun install, run TypeScript files natively, bundle with bun build") to strengthen specificity.

DimensionReasoningScore

Specificity

Lists several specific roles ("runtime, package manager, bundler, and test runner", "migration notes, and Vercel support") with only minor coverage gaps. Not 5 because these are role nouns rather than concrete operations like the top anchor's action verbs; not 3 because coverage goes well beyond 1-2 actions.

4 / 5

Completeness

The "what" is clear ("Bun as runtime, package manager, bundler, and test runner") but the "when" is only weakly implied via "When to choose Bun vs Node" — there is no explicit 'Use when...' clause, which per the judging guidelines caps completeness at 3. Not 4 because anchor 4 requires an explicit if imperfect 'when' statement.

3 / 5

Trigger Term Quality

Natural terms users would say ("Bun", "Node", "Vercel", "migration") with good coverage, matching anchor 4. Not 5 because common variations users say are missing ("bun install", "bun test", "npm", "JavaScript/TypeScript", ".lockfile").

4 / 5

Distinctiveness Conflict Risk

The named tool "Bun" gives a clear niche with distinct triggers, matching anchor 4's "mostly distinct; minor overlap risk with closely related skills" — generic phrases like "runtime, package manager, bundler, and test runner" could overlap with Node/npm/Vercel skills. Not 5 because those generic role words carry more conflict risk than anchor 5's fully concrete triggers.

4 / 5

Total

15

/

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

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository
affaan-m/ECC
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.