bun-development

Fast, modern JavaScript/TypeScript development with the Bun runtime, inspired by [oven-sh/bun](https://github.com/oven-sh/bun).

Quality

56%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./skills/bun-development/SKILL.md

Quality

Content

65%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 comprehensive executable examples, but it is monolithic and somewhat padded, and its destructive migration/install steps lack the validation checkpoints needed for higher workflow clarity.

Suggestions

Add a validation checkpoint to the migration workflow (e.g. run `bun --version` and a smoke test after `rm -rf node_modules package-lock.json` and `bun install`) so destructive steps are verified before proceeding.

Move the detailed API references (Bun.serve/WebSocket/SQLite/password hashing, full matcher list, build API options) into separate reference files under references/ and link to them from SKILL.md to enable progressive disclosure.

Trim the promotional "Why Bun?" comparison table and remove the duplicate brew install instructions to tighten conciseness.

Dimension	Reasoning	Score
Conciseness	Mostly efficient reference material, but padded with a promotional "Why Bun?" comparison table, redundant brew install steps (listed twice), and duplicated "inspired by oven-sh/bun" text, fitting the mostly-efficient-but-could-be-tightened anchor.	3 / 5
Actionability	Nearly every section provides copy-paste ready, executable code and commands (installation, package.json/tsconfig, Bun.file, Bun.serve, SQLite, test matchers, build API, migration steps) covering the common cases comprehensively.	5 / 5
Workflow Clarity	The migration steps run a destructive `rm -rf node_modules package-lock.json` and the installer uses a trap-based cleanup with no validation checkpoints, so per the guidelines workflow clarity is capped at 3 despite the topic-level numbering.	3 / 5
Progressive Disclosure	The ~700-line body has decent section structure but is monolithic — no bundle files exist and detailed API references (Bun.serve, WebSocket, SQLite, matcher list, build options) that belong in separate reference files are fully inlined with no signaled references.	3 / 5
	Total	14 / 20 Passed

Description

48%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 clearly names the Bun niche and is mostly distinct, but it lacks concrete capability actions and any explicit use-when trigger guidance, leaving it mid-range on specificity and completeness.

Suggestions

Add 2-3 concrete capability verbs, e.g. "Run, test, bundle, and compile JS/TS with the Bun runtime" to raise specificity.

Append a 'Use when...' clause with trigger phrases such as starting new JS/TS projects, migrating from Node.js, or using Bun's bundler/test runner to complete the 'when'.

Include synonyms users naturally say (JS, TS, runtime) to broaden trigger-term coverage.

Dimension	Reasoning	Score
Specificity	The description names the domain ("JavaScript/TypeScript development with the Bun runtime") but lists no concrete actions — "development" is abstract with no verbs like run, build, test, or bundle, matching the anchor for minimal/generic actions.	2 / 5
Completeness	It gives a clear "what" (JS/TS development on the Bun runtime) but no "when" — there is no "Use when..." trigger clause, which caps completeness at 3 per the guidelines.	3 / 5
Trigger Term Quality	It includes real natural terms ("Bun", "JavaScript", "TypeScript") that users would say, but offers no synonyms or variations (e.g., JS, TS, runtime, bundler), fitting the anchor for some relevant keywords missing common variations.	3 / 5
Distinctiveness Conflict Risk	The "Bun runtime" niche is clearly distinct from general Node.js/JS skills with only minor overlap risk against closely related JavaScript development skills, matching the mostly-distinct anchor.	4 / 5
	Total	12 / 20 Passed

Validation

87%

Warnings & errors only

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

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (707 lines); consider splitting into references/ and linking	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	14 / 16 Passed

Repository: sickn33/antigravity-awesome-skills
Path: skills/bun-development/SKILL.md
Commit: 1f67c44

Reviewed: about 15 hours ago

Table of Contents

Discovery Implementation Validation

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.