bun-development

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

Quality

48%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/bun-development/SKILL.md

The canonical home for this skill is bun-development in sickn33/agentic-awesome-skills

Quality

Content

64%Scale 1-3

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

This is a comprehensive Bun development skill with excellent actionable code examples covering the full range of Bun capabilities. The main weaknesses are verbosity (comparison tables, explanatory text Claude doesn't need) and lack of validation checkpoints in multi-step workflows like migration and building. The content would benefit from being split into a concise overview with links to detailed topic files.

Suggestions

Remove the 'Why Bun?' comparison table and 'When to Use This Skill' section - Claude can infer these from context

Add validation steps to the migration workflow (e.g., 'Run bun test to verify compatibility before deploying')

Split detailed sections (SQLite, WebSockets, Testing, Bundling) into separate reference files and link from a concise overview

Add error handling examples and recovery steps for common failure scenarios (e.g., build failures, test failures)

Dimension	Reasoning	Score
Conciseness	The skill includes some unnecessary content like the 'Why Bun?' comparison table and explanatory text that Claude already knows. The content is generally efficient but could be tightened by removing the feature comparison and some introductory text.	2 / 3
Actionability	Excellent executable code examples throughout - installation commands, complete TypeScript snippets for file operations, HTTP servers, WebSockets, SQLite, testing, and bundling. All examples are copy-paste ready with proper imports and context.	3 / 3
Workflow Clarity	Steps are listed clearly for tasks like project setup and migration, but validation checkpoints are missing. The migration section lacks verification steps, and the build process doesn't include validation of the output. No feedback loops for error recovery.	2 / 3
Progressive Disclosure	Content is well-organized with clear sections and a quick reference table, but it's a monolithic document (~400 lines) that could benefit from splitting advanced topics (WebSockets, SQLite, bundling) into separate files. External resources are listed but internal progressive disclosure is minimal.	2 / 3
	Total	9 / 12 Passed

Description

32%Scale 1-3

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 identifies the technology domain (Bun runtime for JS/TS) but is too brief and lacks actionable detail. It fails to specify concrete capabilities or provide explicit trigger conditions, making it difficult for Claude to know when to select this skill over other JavaScript-related skills.

Suggestions

Add a 'Use when...' clause with explicit triggers like 'Use when the user mentions Bun, bun.sh, bunx, or wants fast JavaScript/TypeScript execution'

List specific concrete actions such as 'Run scripts, install packages, bundle code, execute tests, and manage dependencies using Bun'

Include common user terms and file patterns like 'bun.lockb', 'bunfig.toml', 'bun run', 'bun install' to improve trigger term coverage

Dimension	Reasoning	Score
Specificity	Names the domain (JavaScript/TypeScript development) and mentions 'Bun runtime' but lacks specific concrete actions like 'run scripts', 'install packages', 'bundle code', or 'test applications'.	2 / 3
Completeness	Partially addresses 'what' (JavaScript/TypeScript development with Bun) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill.	1 / 3
Trigger Term Quality	Includes relevant keywords like 'JavaScript', 'TypeScript', and 'Bun' that users might say, but misses common variations like 'bun run', 'bun install', 'package manager', or file extensions like '.ts', '.js'.	2 / 3
Distinctiveness Conflict Risk	Mentions 'Bun runtime' specifically which helps distinguish from generic JS/TS skills, but 'JavaScript/TypeScript development' is broad and could overlap with Node.js, Deno, or general web development skills.	2 / 3
	Total	7 / 12 Passed

Validation

81%

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 — 9 / 11 Passed

Validation for skill structure

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

	Total	9 / 11 Passed

Repository: administrakt0r/AI-Agents-Safe-Coding-Skills
Path: plugins/AI-Agents-Safe-Coding-Skills/skills/bun-development/SKILL.md
Commit: 7520423

Reviewed: ~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.