CtrlK
BlogDocsLog inGet started
Tessl Logo

nextjs-developer

Use when building Next.js 14+ applications with App Router, server components, or server actions. Invoke for full-stack features, performance optimization, SEO implementation, production deployment.

58

Quality

66%

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-developer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The skill is excellently structured for progressive disclosure — a lean overview routing to five real, flat reference files with load conditions. Its weaknesses are in the body itself: no executable code or commands, no validation checkpoints in the workflow, and two padded sections (persona role definition, keyword-list Knowledge Reference) that spend tokens on what Claude already knows.

Suggestions

Add explicit validation checkpoints to the Core Workflow (e.g., step 4.5: 'Run `next build` and fix type/lint errors before deploying') to move workflow_clarity from 3 toward 4-5.

Replace or trim the 'Knowledge Reference' buzzword list and the '10+ years of experience' persona framing — Claude needs directives, not a résumé or a list of technology names it already knows.

Include one short inline quick-start snippet (e.g., a minimal layout.tsx with Metadata API export, or a 'use client' boundary example) so the body offers executable guidance rather than deferring all detail to references.

DimensionReasoningScore

Conciseness

The body is mostly efficient — tight bulleted MUST DO/MUST NOT lists and a compact workflow — but includes unnecessary padding: the 'Knowledge Reference' section is a bare comma-list of technologies Claude already knows (Turbopack, Streaming SSR, Middleware...), and the Role Definition carries persona fluff ('10+ years of experience', 'blazing-fast'). This fits anchor 3 ('mostly efficient, some unnecessary explanation') better than 4, where over-explanation would be only minor.

3 / 5

Actionability

The constraints name concrete APIs ('use client', next/image, Metadata API, next.config.js) and the output template enumerates deliverables, but the body contains no code, commands, or config snippets — all executable detail is deferred to references with no inline quick-start. This lands at anchor 3 ('some concrete guidance but incomplete'), not 4, which requires concrete code or commands with only minor gaps.

3 / 5

Workflow Clarity

The 5-step Core Workflow (architecture planning → routing → data layer → optimize → deploy) is clearly sequenced, but no validation checkpoints exist anywhere — no 'run next build', no verify-output step, no error-recovery loop. This matches anchor 3 ('sequence present but checkpoints missing') and falls short of 4 ('most checkpoints present').

3 / 5

Progressive Disclosure

SKILL.md is a clear overview with a well-signaled reference table giving Topic, path, and 'Load When' conditions; all five referenced files exist, are one level deep, contain no further nested references, and exactly match the bundle. This matches the 5 anchor ('clear overview with well-signaled one-level-deep references, easy navigation') and exceeds 4, which allows organization gaps — there are none.

5 / 5

Total

14

/

20

Passed

Description

75%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 with explicit, natural trigger language and concrete domain scoping. Its main weakness is that both sentences are 'when' clauses, leaving the 'what' implicit, and a few natural synonyms (Vercel, React) are absent from the description text itself.

Suggestions

Lead with a short capability statement in third person (e.g., 'Develops and ships Next.js 14+ App Router applications...') before the 'Use when' clause so the 'what' is explicit, not just implied.

Add the natural trigger terms that only appear in metadata.triggers (Vercel, React Server Components) to the description itself, since the description is what users see when deciding to invoke.

Replace the generic phrase 'full-stack features' with concrete capabilities (e.g., 'server actions for mutations, data fetching with caching and revalidation') to push specificity from 4 to 5.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'building Next.js 14+ applications with App Router, server components, or server actions', 'performance optimization, SEO implementation, production deployment' — with minor gaps. It falls short of 5 because phrases like 'full-stack features' are generic and the coverage relies on broad category names rather than fully concrete verbs; it exceeds 3 because more than 1-2 specific actions are named.

4 / 5

Completeness

The 'when' is explicit and concrete ('Use when building...', 'Invoke for...'), but the 'what' is only implicit — both sentences are trigger clauses and no separate capability statement (e.g., 'Develops/builds...') states what the skill produces. This matches anchor 4 ('both present, one could be more explicit') rather than 5, and clearly exceeds 3 since 'when' is explicit, not missing.

4 / 5

Trigger Term Quality

Natural trigger terms are present and well-chosen: 'Next.js', 'App Router', 'server components', 'server actions', 'performance optimization', 'SEO', 'production deployment' — terms a user would naturally say. Not 5 because a few natural synonyms/variations are missing from the description itself (e.g., 'Vercel', 'React', 'RSC', 'migration'), which instead live only in the frontmatter triggers metadata.

4 / 5

Distinctiveness Conflict Risk

The niche is clear (Next.js 14+ App Router explicitly, NOT Pages Router is enforced in the body), giving distinct triggers with minimal conflict risk. Not a 5 because the description could overlap with adjacent frontend skills (generic React, TypeScript, or Vercel-deployment skills) — the related-skills metadata itself lists 'typescript-pro'.

4 / 5

Total

16

/

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
zebbern/claude-code-guide
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.