CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

nextjs-turbopack

Next.js 16+ and Turbopack — incremental bundling, FS caching, dev speed, and when to use Turbopack vs webpack.

Quality

72%

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 ./.agents/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 lean, well-structured overview that appropriately stays small and self-contained, scoring well on progressive disclosure. Its weaknesses are repeated "check the docs" hedging, duplicated statements, and thin actionable detail — the command examples are trivial and the one non-obvious feature (Bundle Analyzer) has no concrete config snippet.

Suggestions

Add an executable Bundle Analyzer enablement example (the actual `next.config.js` or CLI flag for a pinned Next.js version) instead of "enable via config or experimental flag (see Next.js docs)".

Consolidate the five "check the official Next.js docs for your version" hedges into a single 'Version notes' line, and state the dev-default fact once instead of in both "When to Use" and "How It Works".

Resolve the flag ambiguity by pinning the disable flag to a concrete version (e.g. "Next.js 16: `next dev --webpack`") so the fallback action is copy-paste ready.

DimensionReasoningScore

Conciseness

The body is short and mostly efficient, but it could be tightened: "Turbopack is default in dev" is stated in both "When to Use" and "How It Works", and the hedge "check/see the official Next.js docs for your version" appears five times (lines 14, 15, 24, 38, 44). That repeated hedging is unnecessary padding, matching anchor 3's "mostly efficient but includes some unnecessary explanation or could be tightened" rather than anchor 4's minor-instances bar.

3 / 5

Actionability

The only concrete commands are the trivial trio `next dev` / `next build` / `next start` (which Claude already knows) and a hedged `--webpack` flag. Key actionable details are deferred outward — Bundle Analyzer is "enable via config or experimental flag (see Next.js docs)" with no config snippet, and the disable flag is "--webpack (or --no-turbopack depending on your Next.js version)" without resolution. This matches anchor 3's "some concrete guidance but incomplete; missing key details", not anchor 4's minor-gap profile.

3 / 5

Workflow Clarity

This is a simple informational skill, so per the rubric's simple-skill exception it can score high on the strength of its unambiguous single action: run `next dev` (Turbopack default), fall back to `--webpack` only on Turbopack bugs or webpack-only plugins, and check the `.next` cache when dev is slow. It falls short of 5 because the fallback flag is version-ambiguous and the decision criteria are spread across two sections with some duplication.

4 / 5

Progressive Disclosure

The body is under 50 lines with no bundle files (references/, scripts/, assets/ are absent) and no content that warrants splitting out. Per the rubric's simple-skill note, well-organized sections alone justify a 5: the four sections (When to Use, How It Works, Examples, Best Practices) are clearly labeled and easy to navigate.

5 / 5

Total

15

/

20

Passed

Description

66%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 specific, niche-scoped description with good natural keywords, but it reads as a topic list rather than a statement of what the skill does, and it lacks the explicit 'Use when...' trigger clause that the rubric requires for full completeness. Adding a concrete trigger sentence would resolve its main weakness.

Suggestions

Append an explicit trigger clause, e.g. "Use when developing or debugging Next.js 16+ apps, or when diagnosing slow dev startup, HMR, or hot-reload issues."

Rephrase the capability list with action verbs (e.g. "Guides dev-bundler choice, configures Turbopack caching, and diagnoses slow HMR") so the 'what' is stated as actions rather than bare topics.

Add the natural synonyms users say aloud — "HMR", "hot reload", "slow dev server" — to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

The description lists several concrete capability areas — "incremental bundling, FS caching, dev speed, and when to use Turbopack vs webpack" — anchored to a specific version ("Next.js 16+"). It falls short of anchor 5 because these are topic nouns rather than explicit actions the skill performs, and coverage of the skill's actual guidance is incomplete.

4 / 5

Completeness

The 'what' is present but topic-style rather than action-oriented ("incremental bundling, FS caching, dev speed"), and the only 'when' phrasing — "when to use Turbopack vs webpack" — describes content, not when to invoke the skill. Per the rubric guideline, a missing explicit 'Use when...' trigger clause caps completeness at 3, which also fits the anchor: clear-ish 'what' with 'when' absent or only weakly implied.

3 / 5

Trigger Term Quality

Strong natural terms a user would say: "Next.js", "Turbopack", "webpack", "dev speed", "bundling". Missing common variations users would actually utter — "HMR", "hot reload", "slow dev server", "build" — so it does not reach anchor 5's comprehensive synonym coverage; it is clearly above anchor 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

"Next.js 16+ and Turbopack" carves out a clear niche with the distinctive trigger "Turbopack". Minor overlap remains with closely related skills — a general Next.js or web-bundling skill would also claim "Next.js", "webpack", and "dev speed" — so it matches anchor 4 rather than anchor 5's minimal-conflict profile.

4 / 5

Total

15

/

20

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

Validation for skill structure

No warnings or errors.

Repository

affaan-m/ECC

Path

.agents/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.