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.
65
77%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/bun/skills/bun-hot-reloading/SKILL.mdQuality
Discovery
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 |
Implementation
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 |
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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- secondsky/claude-skills
- Commit
5e92b71
- 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.