CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bun-bundler

This skill should be used when the user asks about "bun build", "Bun.build", "bundling with Bun", "code splitting", "tree shaking", "minification", "sourcemaps", "bundle optimization", "esbuild alternative", "building for production", "bundling TypeScript", "bundling for browser", "bundling for Node", or JavaScript/TypeScript bundling with Bun.

56

Quality

71%

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

Quality

Content

71%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 delivers highly actionable, executable Bun bundling guidance with strong error-handling coverage, but it is padded with repeated try/catch and near-identical target examples, inlines the full options reference that belongs in references/options.md, and points to two reference files that don't exist. Trimming duplication and fixing the broken references would move this to top-tier.

Suggestions

Fix the reference set: either create references/plugins.md and references/macros.md or remove them from 'When to Load References' — as written, two of three load instructions lead nowhere.

Move the full 'Bun.build Options' block into references/options.md (which already exists) and keep only 3-4 key options inline in SKILL.md.

Collapse the three Target Environments code blocks into one example with a comment listing target values, and state the try/catch idiom once in the JavaScript API section rather than repeating it in 'Build Output' and 'Build Script'.

DimensionReasoningScore

Conciseness

The body mostly avoids explaining concepts Claude already knows and leads with runnable code, but contains real redundancy: the full Bun.build options block, a near-identical 'Build Output' block, and a 'Build Script' block all repeat the same try/catch pattern three times, and the three Target Environments sections each show the same config differing only in one string. This is 'mostly efficient but includes some unnecessary explanation or could be tightened' (anchor 3), not anchor 4's 'minor instances'.

3 / 5

Actionability

Examples are fully executable and copy-paste ready: CLI commands, a complete Bun.build options object with valid values annotated, a working plugin with onResolve/onLoad hooks, output iteration, and a Common Errors table with cause/fix. The examples cover the common cases (browser/node/bun targets, production, library, build script) — matching anchor 5's 'copy-paste ready code covering the common cases'.

5 / 5

Workflow Clarity

The path from quick start through configuration to common patterns is clearly sequenced, and the Common Errors table provides error-recovery guidance, but there are no explicit validation checkpoints (e.g., verifying outputs landed in ./dist or inspecting chunk counts). Builds are not destructive/batch edits of user data, so the workflow-clarity cap at 3 does not apply; this is anchor 4 ('clear sequence with most checkpoints; minor validation gaps') rather than anchor 5's explicit validate-fix-retry loop.

4 / 5

Progressive Disclosure

The body has good section structure and an explicit 'When to Load References' section, but two of the three referenced files (references/plugins.md, references/macros.md) do not exist in the bundle, and the complete Bun.build options reference is inlined in SKILL.md even though references/options.md exists for exactly that purpose. Scoring against the actual bundle, this is anchor 3 ('references present but not clearly backed by real files; content that should be separate is inline') — the broken reference paths and inlined bulk rule out anchor 4.

3 / 5

Total

15

/

20

Passed

Description

60%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 trigger-rich and unambiguous about when to fire, with excellent natural keyword coverage, but it omits any statement of what the skill actually does, leaving the 'what' half of the contract implicit. Adding a short capability lead-in would lift completeness substantially.

Suggestions

Add a 'what' clause before the trigger list, e.g., 'Documents Bun's JavaScript/TypeScript bundler: CLI usage, Bun.build API, targets, splitting, minification, and sourcemaps. Use when...' — this converts trigger nouns into stated actions and fixes completeness.

Consider making Bun-adjacent generic terms ('minification', 'code splitting') conditional on the Bun context to reduce overlap with esbuild/webpack skills.

DimensionReasoningScore

Specificity

The description names the domain clearly ('bundling with Bun') and the trigger list enumerates concrete feature nouns like "code splitting", "tree shaking", "minification", and "sourcemaps", but it never states concrete actions the skill performs — there is no 'bundles', 'configures', or 'optimizes' verb phrase. This sits between anchor 2 ('actions are minimal or generic') and anchor 4 ('lists several specific actions'), matching anchor 3's domain-plus-limited-concrete-capabilities level.

3 / 5

Completeness

The 'when' is explicitly and thoroughly answered ('This skill should be used when the user asks about...'), but the 'what' is entirely absent — the description never says what the skill does (e.g., 'Documents Bun's bundler API and CLI...'). This matches anchor 2 ('only when is present without what') exactly; it cannot be a 3 because anchor 3 requires a clear 'what'.

2 / 5

Trigger Term Quality

Trigger terms are comprehensive and natural: "bun build", "Bun.build", "bundling with Bun", "code splitting", "tree shaking", "minification", "sourcemaps", "esbuild alternative", "building for production", "bundling TypeScript", "bundling for browser", "bundling for Node" — covering the CLI name, the API name, synonyms, and task-level phrasings a user would actually say. It is not below anchor 5 because essentially no natural variation for this domain is missing.

5 / 5

Distinctiveness Conflict Risk

Bun-specific triggers ("bun build", "Bun.build", "bundling with Bun") are highly distinct, but generic bundler terms like "minification", "code splitting", "tree shaking", and "building for production" would also match an esbuild or webpack skill. This is 'mostly distinct; minor overlap risk with closely related skills' (anchor 4), not anchor 5, since several triggers are not Bun-exclusive.

4 / 5

Total

14

/

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: 2 missing

Warning

Total

15

/

16

Passed

Repository

secondsky/claude-skills

Path

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