bun-hot-reloading

Use when implementing hot reloading with Bun (--hot, --watch), HMR, or automatic code reloading during development. Covers watch mode, hot mode, and HTTP server reload.

Quality

77%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Passed

No known issues

Fix and improve this skill with Tessl

tessl review fix ./plugins/bun/skills/bun-hot-reloading/SKILL.md

Quality

Content

64%

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

This is a solid, highly actionable skill with excellent executable code examples covering Bun's hot reloading capabilities comprehensively. Its main weaknesses are length (could benefit from moving advanced patterns to reference files) and the lack of a clear step-by-step setup workflow. The referenced files don't exist in the bundle, undermining the progressive disclosure strategy.

Suggestions

Move advanced patterns (WebSocket Live Reload, Custom Watch Implementation, Vite Integration) into referenced files to reduce the main SKILL.md length and improve progressive disclosure.

Add a brief 'Getting Started' workflow at the top with numbered steps: 1) Choose watch vs hot mode, 2) Add script to package.json, 3) Verify reload works by making a change.

Create the referenced bundle files (references/advanced-hmr.md, references/debugging.md) or remove the references if they don't exist.

Dimension	Reasoning	Score
Conciseness	The skill is mostly efficient with good use of tables and code examples, but it's quite long (~250 lines) with some sections that could be trimmed. The Vite integration section and WebSocket live reload are tangential to Bun's built-in hot reloading. Some patterns (custom watch implementation) add bulk without being core to the skill's purpose.	2 / 3
Actionability	Excellent actionability throughout — every section provides fully executable, copy-paste ready code with specific bash commands, TypeScript examples, and package.json configurations. The import.meta.hot API section is comprehensive with concrete usage patterns.	3 / 3
Workflow Clarity	The comparison table clearly distinguishes watch vs hot mode, and the common issues section provides good error-fix patterns. However, there's no explicit workflow sequence for setting up hot reloading from scratch, and the common errors section lacks validation/verification steps — it's more of a troubleshooting reference than a guided workflow.	2 / 3
Progressive Disclosure	The skill references 'references/advanced-hmr.md' and 'references/debugging.md' at the bottom with clear loading criteria, which is good. However, no bundle files exist to support these references, and the main content is quite long — sections like WebSocket Live Reload and Custom Watch Implementation could be split into reference files to keep the SKILL.md leaner.	2 / 3
	Total	9 / 12 Passed

Description

89%

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 a solid skill description with excellent trigger term coverage and clear 'Use when' guidance that makes it easy for Claude to select appropriately. The main weakness is that it describes topic coverage rather than specific actions the skill enables (e.g., 'configure hot reloading', 'troubleshoot HMR issues'). Overall it performs well for skill selection purposes.

Suggestions

Add specific concrete actions the skill performs, e.g., 'Configures and troubleshoots hot reloading with Bun' rather than just 'Covers watch mode, hot mode...'

Dimension	Reasoning	Score
Specificity	Names the domain (hot reloading with Bun) and mentions some specific modes (watch mode, hot mode, HTTP server reload), but doesn't list concrete actions like 'configure', 'set up', or 'debug'. It describes coverage areas rather than specific actions the skill performs.	2 / 3
Completeness	Explicitly answers both 'what' (hot reloading with Bun, covering watch mode, hot mode, HTTP server reload) and 'when' ('Use when implementing hot reloading with Bun...or automatic code reloading during development') with a clear 'Use when' clause.	3 / 3
Trigger Term Quality	Excellent coverage of natural trigger terms: '--hot', '--watch', 'HMR', 'hot reloading', 'Bun', 'watch mode', 'hot mode', 'automatic code reloading', 'development'. These are terms users would naturally use when asking about this topic.	3 / 3
Distinctiveness Conflict Risk	Highly distinctive — specifically scoped to Bun's hot reloading features with distinct flags (--hot, --watch) and Bun-specific terminology. Unlikely to conflict with general file watching, other runtime hot reloading, or broader Bun skills.	3 / 3
	Total	11 / 12 Passed

Validation

100%

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

Validation for skill structure

No warnings or errors.

Repository: secondsky/claude-skills
Commit: 5e92b71

Reviewed: about 2 months 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.