CtrlK
BlogDocsLog inGet started
Tessl Logo

pleaseai/bun

All-in-one JavaScript/TypeScript toolkit: fast runtime, package manager, test runner, and bundler. Version-aware skill backed by the ask CLI.

75

Quality

94%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Overview
Quality
Evals
Security
Files

Quality

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is an excellent skill description that thoroughly covers Bun's ecosystem with highly specific capabilities, extensive natural trigger terms, explicit 'Use when' guidance, and clear distinctiveness from related JavaScript tooling skills. The description uses proper third-person voice and avoids vague language. The only minor concern is that it is quite long, but the density of useful trigger terms justifies the length.

DimensionReasoningScore

Specificity

The description lists numerous specific concrete actions: answering questions about Bun, writing code using its runtime/package manager/test runner/bundler, calling specific APIs (Bun.serve, Bun.file, etc.), importing specific modules, running CLI commands, configuring bunfig.toml, writing tests with specific utilities, and handling migration scenarios.

3 / 3

Completeness

The description clearly answers 'what' (answer questions about Bun, write code using its toolkit components) and 'when' with an explicit 'Use when' clause followed by extensive trigger scenarios covering API calls, module imports, CLI commands, configuration, testing, and migration needs.

3 / 3

Trigger Term Quality

Excellent coverage of natural terms developers would use: 'Bun', specific API names like 'Bun.serve', 'Bun.file', CLI commands like 'bun install', 'bun test', 'bunx', module names like 'bun:test', 'bun:sqlite', config files like 'bunfig.toml', and migration terms like 'npm/yarn/pnpm/jest/vitest'. These are exactly what a developer would mention.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive — the description is laser-focused on Bun specifically, with Bun-native API names, Bun-specific modules, and Bun CLI commands that clearly distinguish it from generic JavaScript/Node.js skills or other runtime/bundler skills. The mention of 'migration from npm/yarn/pnpm/jest/vitest' further clarifies its niche.

3 / 3

Total

12

/

12

Passed

Implementation

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured, comprehensive skill for working with Bun across versions. Its greatest strengths are the clear workflow for version-aware development, the excellent topic map for progressive disclosure into reference files, and concrete executable commands throughout. The main weakness is some verbosity in the version-specific pitfalls section and minor redundancy in version-resolution instructions, though this information is genuinely valuable given Bun's rapid API evolution.

Suggestions

Tighten the 'Critical: Do Not Trust Internal Knowledge' section by converting the verbose bullet points into a compact table (Feature | Min Version | Notes) to save tokens while preserving the same information.

DimensionReasoningScore

Conciseness

The content is mostly efficient and provides genuinely useful version-specific information Claude wouldn't know, but the 'Critical: Do Not Trust Internal Knowledge' section is quite verbose with extensive bullet-point explanations. The migration table and decision points are well-structured but some entries include unnecessary elaboration (e.g., explaining what dotenv does). The repeated version-resolution instructions appear in both Prerequisites and the numbered workflow.

2 / 3

Actionability

The skill provides fully executable bash commands for version resolution, `ask` CLI usage, and `rg`/`ls` commands for documentation lookup. The migration table gives concrete from/to mappings, and the decision points section provides specific API recommendations with version constraints. Code examples are copy-paste ready.

3 / 3

Workflow Clarity

The numbered workflow (resolve version → verify API via `ask` → cross-reference docs at matching tag → confirm with `bun --print` → surface trade-offs) is clearly sequenced with explicit validation checkpoints. The version resolution has a clear priority order, and there's an explicit fallback instruction ('If documentation cannot be found... say so explicitly').

3 / 3

Progressive Disclosure

The Topic Map table provides an excellent one-level-deep reference structure with clear 'When' guidance for each reference file. References to `references/versions.md`, `references/runtime-apis.md`, `references/package-manager.md`, etc. are well-signaled with markdown links and contextual descriptions. The instruction to 'load the focused reference for the area you're touching — do not read all of them upfront' is ideal progressive disclosure.

3 / 3

Total

11

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Reviewed

Table of Contents