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

70%

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 well-organized, appropriately short overview that makes the Turbopack-vs-webpack decision clear, with no bundle files needed. Its weaknesses are repeated 'check the docs' hedges that pad the text and under-specified guidance (bare commands, no Bundle Analyzer config snippet) that keeps it from being fully actionable.

Suggestions

Consolidate the version-drift hedging into a single note (e.g. one line: 'Build behavior and flags vary by Next.js release — verify in the official docs') instead of repeating it five times.

Replace vague deferrals with concrete guidance: show the actual config snippet to enable the Bundle Analyzer and the exact flags for `next build`, rather than 'enable via config or experimental flag (see Next.js docs)'.

Drop generic advice Claude already knows ('Prefer App Router and server components where possible') and give the Examples commands purpose (e.g. annotate `next build` with the relevant Turbopack/webpack flags per version).

DimensionReasoningScore

Conciseness

The body is mostly efficient and well-sectioned, but it repeats the hedge "check the (official) Next.js docs for your version" in five places (When to Use, Production, Bundle Analyzer, Usage, Best Practices) and includes generic advice Claude already knows ("Prefer App Router and server components where possible"). This puts it above score 2 (several padded sections) but short of score 4's 'only minor over-explanation' since the repetition is noticeable and could be consolidated once.

3 / 5

Actionability

Concrete commands are present (`next dev`, `next build`, `next start`, `--webpack`, `--no-turbopack`), but the Examples block lists bare commands with no flags or context, and the Bundle Analyzer section defers with "enable via config or experimental flag (see Next.js docs)" — no actual config snippet. This matches the score-3 anchor (some concrete guidance, incomplete, key details missing) rather than score 4, which requires mostly executable guidance with only minor gaps.

3 / 5

Workflow Clarity

This is a simple, single-purpose decision/reference skill under 50 lines, so the simple-skill exception applies; the core actions (run `next dev` for Turbopack; fall back to `--webpack` if a bug hits) are unambiguous and the sections are clearly organized, placing it above score 3. It falls short of 5 because the promised diagnostic scenarios ('diagnosing slow dev startup or HMR', 'diagnosing' lacks any sequenced steps) have no order of checks — e.g. verify version, confirm Turbopack is active, check cache — leaving minor sequence gaps.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/ directories), and the skill is under 50 lines with no need for external references, so per the judging guidelines a 5 is appropriate for well-organized sections alone. The body is cleanly split into When to Use, How It Works, Examples, and Best Practices with no inlined content that belongs in separate files, and all detail stays one level deep (external web docs, not nested bundle references).

5 / 5

Total

15

/

20

Passed

Description

61%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 focused, distinctive description that names its niche clearly, but it reads as a topic list rather than a statement of capabilities, and it lacks an explicit 'Use when...' invocation clause. Trigger terms are good though missing hot-reload/HMR variants.

Suggestions

Add an explicit 'Use when' clause, e.g. 'Use when developing or debugging Next.js 16+ apps, diagnosing slow dev startup or hot reload, or choosing between Turbopack and webpack.'

Convert topic nouns into concrete actions (e.g. 'Diagnose slow Next.js dev startup, enable and configure Turbopack, fall back to webpack, analyze bundle size') so capabilities are explicit rather than inferred.

Include natural trigger variants users say, such as 'hot reload', 'HMR', and 'build performance', to broaden keyword coverage.

DimensionReasoningScore

Specificity

Names the domain precisely ("Next.js 16+ and Turbopack") and lists concrete topics ("incremental bundling, FS caching, dev speed"), but these are noun-phrase subject areas rather than explicit actions the skill performs; only "when to use Turbopack vs webpack" is a verb-like capability. It sits above the score-2 anchor (which has merely generic actions) but below score 4, which expects several specific actions with only minor gaps.

3 / 5

Completeness

The 'what' is reasonably clear (incremental bundling, FS caching, dev speed), and "when to use Turbopack vs webpack" is only a partial, intra-scope 'when' — it describes choosing a bundler, not when to invoke the skill. There is no explicit 'Use when...' invocation clause covering developing/debugging Next.js 16+ apps or slow dev startup/HMR, so per the judging guidelines completeness is capped at 3.

3 / 5

Trigger Term Quality

Contains strong natural terms users would actually say — "Next.js", "Turbopack", "webpack", "dev speed" — plus technical phrases like "incremental bundling". It misses common variations such as "hot reload", "HMR", "slow dev startup", and "build time", which keeps it below the score-5 comprehensive-coverage anchor but comfortably above score 3's 'some keywords, missing variations'.

4 / 5

Distinctiveness Conflict Risk

Turbopack/Next.js 16+ is a clear niche with distinct triggers, so it is well above score 3's overlap risk. However, generic "Next.js" queries (App Router, server components) and "webpack" queries could pull this skill in where it adds little, leaving minor overlap risk with hypothetical general Next.js or webpack skills, which keeps it just below score 5's 'minimal conflict risk'.

4 / 5

Total

14

/

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

ysyecust/everything-claude-code

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.