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

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

Quality

Content

76%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, highly actionable reference: executable commands and API examples cover running, installing, testing, bundling, migrating from Node, and Vercel deployment. Its main weakness is the absence of validation checkpoints in the migration and deploy workflows, plus a few lines of generic advice that could be trimmed.

Suggestions

Add an explicit verification step to the Node migration workflow, e.g. 'After `bun install`, run `bun test` and the app's entry script to confirm packages work under Bun.'

Include a fallback/checkpoint for the Vercel section, such as verifying the build output (`bun build --outdir=dist`) or checking deploy logs when the runtime isn't picked up.

Trim generic filler — the restated intro line and the 'keep dependencies up to date' best practice — so every token earns its place.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — commands and API snippets dominate, with no tutorial padding. Minor trimmable instances remain: the opening line 'Bun is a fast all-in-one JavaScript runtime and toolkit…' restates the frontmatter description, and 'Keep dependencies up to date; Bun and the ecosystem evolve quickly' is generic advice, so it sits at 'efficient; minor instances of over-explanation' rather than fully lean.

4 / 5

Actionability

Fully executable, copy-paste-ready guidance covering the common cases: `bun install`, `bun run src/index.ts`, `bun test --watch`, `bun build ./src/index.ts --outdir=dist`, `bun run --env-file=.env dev`, plus working `Bun.file`/`Bun.serve` TypeScript examples and concrete migration replacements (`node script.js` → `bun run script.js`). Every snippet is runnable as written.

5 / 5

Workflow Clarity

The migration and Vercel sections list concrete, well-ordered steps ('Replace node script.js with bun… Run bun install in place of npm install'), but neither includes verification checkpoints — e.g. 'run bun test after migrating to confirm nothing broke' or 'verify the Vercel build output'. The sequence is clear, yet validation is absent, matching 'steps listed but validation gaps' rather than the 'most checkpoints present' level.

3 / 5

Progressive Disclosure

A single well-organized file with clear sections (When to Use, How It Works, Examples, Best Practices), no nested or buried references, and nothing that obviously belongs in a separate file — good structure with only minor gaps (the Examples section could be split out if the skill grows). It does not reach 5 because at ~85 lines it slightly exceeds the lean single-file size where inline-everything is ideal, and it just misses the 'well-signaled one-level-deep references' ideal.

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.

A strong, compact description that names Bun's four concrete roles and explicitly addresses when to reach for it (choosing vs Node, migrating, Vercel). The 'when' clause is present but phrased as a topic rather than a direct 'Use when…' trigger, and keyword variations are slightly thin.

Suggestions

Rewrite the second sentence as an explicit trigger clause, e.g. 'Use when adopting Bun, migrating a Node project to Bun, or configuring the Bun runtime on Vercel.'

State capabilities as concrete actions rather than topic nouns — e.g. 'Runs scripts, installs dependencies, bundles apps, and runs tests' — to sharpen specificity.

Add one or two common natural variations users say, such as 'bun install' or 'TypeScript runtime', to broaden trigger coverage.

DimensionReasoningScore

Specificity

Enumerates several concrete capability areas — "runtime, package manager, bundler, and test runner" plus "migration notes" and "Vercel support" — matching the 'several specific actions; minor gaps' anchor. Not 5 because these are topic nouns rather than concrete actions (no 'run scripts', 'install dependencies', 'migrate projects') and coverage of capabilities like Bun's API is absent; not 3 because it lists far more than 1-2 concrete items.

4 / 5

Completeness

Both parts are present: the 'what' is "Bun as runtime, package manager, bundler, and test runner", and the 'when' is "When to choose Bun vs Node" — explicitly stated, not merely implied. Not 5 because the 'when' is framed as a decision topic rather than a direct 'Use when…' trigger clause with concrete trigger phrases; not 3 because the 'when' is explicit rather than missing or weakly implied.

4 / 5

Trigger Term Quality

Good natural keyword coverage: "Bun", "Node", "Vercel", "migration", "runtime", "test runner" are terms users would actually say. Not 5 because common variations and tool-specific phrases are missing (e.g. "bun install", "npm", "TypeScript", "lockfile"); not 3 because coverage clearly goes beyond 'some relevant keywords' with multiple well-chosen natural terms.

4 / 5

Distinctiveness Conflict Risk

"Bun" is a clear, distinctive niche keyword, making mis-triggering unlikely for most requests. Not 5 because "Bun vs Node" explicitly names Node, creating minor overlap risk with general Node.js skills; not 3 because the domain is firmly anchored to Bun, far more specific than 'somewhat specific'.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

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.