CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

64

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/bun/skills/bun-nextjs/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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, mostly lean reference with executable code throughout and a clear cookbook organization, capped by a progressive-disclosure defect: it directs the reader to two reference files that are absent from the bundle. Version-specific notes (Next.js 16 Turbopack/proxy) are appropriately framed as current-vs-deprecated guidance rather than bare dates.

Suggestions

Ship the actual references/app-router.md and references/caching.md files, or remove the 'When to Load References' section — pointing readers at nonexistent files breaks the skill's navigation.

Drop the duplicate Node-runtime package.json scripts block (the 'Use Bun as Runtime' variant alone suffices) and cut generic Performance Tips Claude already knows (server components, SQLite-vs-external-DB).

Add a quick validation checkpoint to the deployment flows, e.g. run `bun run start` locally and confirm the port responds before Docker/Vercel deploy.

DimensionReasoningScore

Conciseness

The body is code-first and largely efficient (quick start, config snippets, error table), with only minor over-explanation: the package.json scripts are shown twice (Node vs Bun variants) and Performance Tips includes knowledge Claude already has ("Prefer Server Components - Less JavaScript sent to client", "Use Bun SQLite instead of external databases"). This matches the 4 anchor rather than the every-token-earns-its-place 5.

4 / 5

Actionability

Everything is concrete and executable: complete quick-start commands, a full next.config.js, copy-paste-ready TypeScript for routes/actions/proxy, a Dockerfile, and an error/cause/fix table. Code is complete rather than pseudocode, matching the 5 anchor.

5 / 5

Workflow Clarity

The Quick Start and Docker flows are clearly sequenced (create → install → dev → build → start; COPY → install --frozen-lockfile → build → run), and the Common Errors table provides recovery guidance. There are no destructive or batch operations requiring validation loops, but checkpoints like verifying the build before deploying are only implicit, fitting the 4 anchor rather than 5.

4 / 5

Progressive Disclosure

A well-signaled 'When to Load References' section exists, but both referenced files (references/app-router.md and references/caching.md) do not exist in the bundle, so the navigation points at missing files and no advanced content is actually offloaded. The in-body structure is decent, matching the 3 anchor (structure present but organization incomplete) rather than 4, since broken references are more than a minor gap.

3 / 5

Total

16

/

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.

A well-targeted description with an explicit trigger clause and clear niche, weakened by a thin 'what' — it never states the concrete actions the skill performs (scaffolding, configuration, deployment, using Bun APIs from Next.js). Trigger phrasing is good but mostly repetitions of the same two keywords.

Suggestions

Lead with the 'what': e.g., 'Run, build, and deploy Next.js applications on Bun as the runtime — scaffolding, bunfig/package.json configuration, Bun API usage in Server Components and routes, and Docker/Vercel deployment.'

State the 'when' once with a concise set of trigger phrases instead of six near-duplicate quoted variants, and add missing natural terms like "bunx create-next-app" and "Bun instead of Node for Next.js".

DimensionReasoningScore

Specificity

The description names the domain (Next.js + Bun) and one concrete capability ("building Next.js applications using Bun as the runtime"), matching the anchor for 1-2 concrete actions without comprehensive coverage. It does not list the several specific actions (scaffold, configure, deploy, use Bun APIs) that would justify a 4, but it goes beyond the minimal action-free anchor at 2.

3 / 5

Completeness

It has an explicit and concrete 'when' clause ("should be used when the user asks about...") and a 'what' ("building Next.js applications using Bun as the runtime"). The 'what' is thin and could be more explicit about what the skill actually does, so it matches the 4 anchor rather than the fully explicit 5.

4 / 5

Trigger Term Quality

Quoted phrases like "Next.js with Bun", "running Next.js on Bun", and "create-next-app with Bun" are natural user phrasings with good variation coverage. A few natural terms are missing (e.g., "bunx create-next-app", "Bun instead of Node"), so it falls just short of the comprehensive synonym coverage of the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The description requires the specific Next.js-on-Bun pairing, giving it a clear niche with distinct triggers and minimal conflict risk with general Next.js or Bun-only skills, matching the 5 anchor.

5 / 5

Total

16

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

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

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.