CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

nextjs-turbopack

Next.js 16+ and Turbopack guidance — incremental Rust bundling, file-system caching, faster dev startup and HMR, Turbopack vs webpack tradeoffs, and the middleware.ts to proxy.ts filename change. Use when developing or debugging Next.js 16+ apps, diagnosing slow dev startup or hot reload, choosing between bundlers, or reviewing middleware/proxy file naming.

Quality

79%

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 ./skills/nextjs-turbopack/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 tight, well-sectioned reference skill whose strongest part is the unambiguous proxy.ts/middleware.ts guidance with an explicit warning against mis-flagging. Its weakness is hedged, version-qualified claims ('check the docs for your version') that hurt both actionability and conciseness, plus some redundancy across sections.

Suggestions

Collapse the repeated 'Turbopack is the default in Next.js 16+' statements (intro, When to Use, How It Works) into a single statement, and remove the bare `next dev`/`next build`/`next start` command block since Claude already knows these commands.

Replace the 'check the official Next.js docs for your version' hedges with the concrete per-version facts (e.g. the exact flag to disable Turbopack and the exact Bundle Analyzer config), or move version-specific detail into a clearly labeled 'Version notes / old patterns' section.

Turn the Best Practices bullets into concrete verification steps (e.g. how to confirm Turbopack is active in dev output, how to check the cache directory before clearing it) so the diagnosis path is executable rather than advisory.

DimensionReasoningScore

Conciseness

Mostly efficient, but it restates the Turbopack-is-default fact three times (intro, 'When to Use', 'How It Works'), lists trivial known commands (`next dev`, `next build`, `next start`), and repeats time-sensitive hedged claims ('check the docs for your version', 'check the official Next.js docs for your version') that could be consolidated. Not score 4 because the redundancy goes beyond minor trimmable instances; not score 2 because there is no padded conceptual tutorial text.

3 / 5

Actionability

Some concrete guidance exists (`--webpack` flag, proxy.ts vs middleware.ts naming, cache location under `.next`, the explicit 'Do not flag proxy.ts' instruction), but key details are deferred with vague hedges like 'enable via config or experimental flag (see Next.js docs for your version)' and 'may use Turbopack or webpack depending on Next.js version; check the official docs'. Not score 4 because several actionable claims stop short of the actual command/config; not score 2 because the middleware naming and bundler-selection guidance is genuinely concrete.

3 / 5

Workflow Clarity

As a decision-guide skill, its conditions are clearly sequenced: when to use Turbopack vs webpack, when to use proxy.ts vs middleware.ts, plus a diagnosis path ('If dev is slow, ensure you're on Turbopack...'). Not score 5 because the version-dependent branches resolve to 'check the docs' rather than a decisive checkpoint, leaving minor gaps; not score 3 because each decision point has an explicit condition and outcome rather than vague steps.

4 / 5

Progressive Disclosure

The body is ~50 lines with well-organized sections (When to Use, How It Works, Examples, Middleware File Naming, Best Practices), no bundle files exist, no references are dangled to nonexistent files, and the single external link (Next.js proxy docs) is clearly signaled at one level of depth. This matches the under-50-line simple-skill case where well-organized sections alone earn a 5.

5 / 5

Total

15

/

20

Passed

Description

87%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 strong description: it states a concrete capability set and an explicit, multi-trigger 'Use when' clause in third person, with version-pinned terminology that keeps conflict risk low. Its only soft spot is that the what-clause enumerates topics more than discrete actions.

DimensionReasoningScore

Specificity

It lists several concrete capabilities: 'incremental Rust bundling, file-system caching, faster dev startup and HMR, Turbopack vs webpack tradeoffs, and the middleware.ts to proxy.ts filename change'. Not score 5 because these are topic nouns rather than executable action verbs (no 'diagnose/choose/review'-style what-it-does verbs in the what-clause); not score 3 because coverage is broad and each named capability is concrete, not generic.

4 / 5

Completeness

It explicitly answers both what ('Next.js 16+ and Turbopack guidance — incremental Rust bundling, file-system caching...') and when ('Use when developing or debugging Next.js 16+ apps, diagnosing slow dev startup or hot reload, choosing between bundlers, or reviewing middleware/proxy file naming') with concrete trigger phrases. This matches the anchor-5 example structure directly; score 4 would require the 'when' clause to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'Next.js 16+ apps', 'Turbopack', 'slow dev startup', 'hot reload', 'choosing between bundlers', 'middleware/proxy file naming' — phrases a user would plausibly say. Not score 5 because common synonyms/extensions (e.g. 'webpack dev server slow', 'HMR', '.next cache', 'build times') are only partially covered; not score 3 because both the primary terms and several natural variations are present.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Next.js 16+/Turbopack/proxy.ts) with distinct triggers like 'Turbopack vs webpack tradeoffs' and 'middleware.ts to proxy.ts filename change' that no general web-dev or Next.js-general skill would claim as its core. Not score 4 because the version-pinned terms make overlap with adjacent skills minimal rather than merely minor.

5 / 5

Total

18

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

affaan-m/ECC

Path

skills/nextjs-turbopack/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.