bun-nextjs

This skill should be used when the user asks about "Next.js with Bun", "Bun and Next", "running Next.js on Bun", "Next.js development with Bun", "create-next-app with Bun", or building Next.js applications using Bun as the runtime.

Quality

78%

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/bun/skills/bun-nextjs/SKILL.md

Quality

Content

82%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.

A highly actionable, well-structured reference with copy-paste code across the full Next.js-on-Bun lifecycle; the main weakness is referencing bundle files that do not exist in the skill package.

Suggestions

Add the missing references/app-router.md and references/caching.md files to the bundle, or remove the 'When to Load References' section if those details are not maintained.

Trim explanatory restatements like 'The --bun flag forces Next.js to use Bun's runtime instead of Node.js' where the preceding code already makes the intent clear.

Consider a short validate step in the Docker/build flow (e.g., run `bun run build` then a smoke check before `start`) to add an explicit checkpoint.

Dimension	Reasoning	Score
Conciseness	Largely lean and code-dense with targeted notes (e.g., the Cloudflare/OpenNext caveat, the webpack-deprecation note); minor over-explanation like 'The --bun flag forces Next.js to use Bun's runtime instead of Node.js' keeps it just below the fully-lean anchor 5.	4 / 5
Actionability	Fully executable, copy-paste-ready code and commands cover the common cases across Quick Start, server components, API routes, server actions, proxy, Docker, and Vercel, matching the fully-executable anchor.	5 / 5
Workflow Clarity	The Quick Start gives a clear create -> install -> dev -> build -> start sequence and the Secure Installation section is process-oriented; as a reference/catalog skill with no destructive or batch operations, no validation cap applies, but it lacks an explicit validate->fix->retry loop so it stops short of anchor 5.	4 / 5
Progressive Disclosure	Well-organized sections with clearly signaled one-level-deep references ('Load references/app-router.md when...', 'references/caching.md when...'); held below 5 because those referenced files are not present in the bundle, a moderate organization gap.	4 / 5
	Total	17 / 20 Passed

Description

73%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 has excellent explicit trigger guidance and a distinct niche, but leans on trigger phrasing rather than enumerating concrete capabilities, leaving the 'what' somewhat thin.

Suggestions

Lead with a concise capability clause (e.g., 'Scaffolds, runs, builds, and deploys Next.js applications on the Bun runtime') before the trigger list to strengthen the 'what'.

Add a couple of capability verbs beyond 'running/building' (e.g., 'uses Bun APIs like bun:sqlite and Bun.file in server components and API routes') to lift specificity.

Dimension	Reasoning	Score
Specificity	Names the domain and 1-2 actions ('running Next.js on Bun', 'building Next.js applications using Bun as the runtime') but offers no comprehensive list of concrete capabilities, sitting between the minimal-action anchor 2 and the several-actions anchor 4.	3 / 5
Completeness	Both 'what' (running/building Next.js on the Bun runtime) and a very explicit 'when' clause with concrete triggers are present, but the 'what' is trigger-folded and capability-thin rather than a clear standalone capability list like the anchor-5 example.	4 / 5
Trigger Term Quality	Strong natural trigger coverage with synonyms ('Next.js with Bun', 'Bun and Next', 'running Next.js on Bun', 'create-next-app with Bun'); just below 5 because the terms are variations of one concept rather than diverse entry points with extensions.	4 / 5
Distinctiveness Conflict Risk	The specific 'Next.js with Bun' niche has distinct triggers and minimal conflict risk with other skills, matching the clear-niche anchor.	5 / 5
	Total	16 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
referenced_paths_exist	Referenced path issues: 2 missing	Warning

	Total	15 / 16 Passed

Repository: secondsky/claude-skills
Path: plugins/bun/skills/bun-nextjs/SKILL.md
Commit: ad16332

Reviewed: 12 days 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.