CtrlK
BlogDocsLog inGet started
Tessl Logo

next-cache-components

Next.js 16 Cache Components - PPR, use cache directive, cacheLife, cacheTag, updateTag

61

Quality

71%

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/next-cache-components/upstream/SKILL.md

The canonical home for this skill is next-cache-components in vercel/vercel-plugin

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 strong, highly actionable reference for Next.js 16 Cache Components: nearly all guidance is executable, version-specific, and free of filler. The gaps are structural — everything lives inline in one long SKILL.md with no reference files, and some sections (directive placement, complete example) repeat content that could be consolidated or split out.

Suggestions

Split the migration section and the complete dashboard example into a references/ file (e.g. references/migration.md), keeping SKILL.md as a lean quick-start overview.

Consolidate the three near-identical file/component/function-level 'use cache' placement examples into one example annotated with the three options.

Add a short decision checklist for choosing a content type (static vs cached vs dynamic) and for picking between updateTag and revalidateTag.

DimensionReasoningScore

Conciseness

The body is dense and code-first, focused on version-specific behavior Claude cannot reliably know (updateTag vs revalidateTag semantics, cacheLife profiles, cache-key closure rules), but has minor trimmable redundancy — the three near-identical 'use cache' placement examples and the Complete Example section restate earlier patterns. This fits anchor 4 (efficient, minor instances that could be trimmed) rather than anchor 5 (every token earns its place).

4 / 5

Actionability

Every section provides copy-paste-ready TSX — the next.config.ts cacheComponents block, file/component/function-level 'use cache' variants, cacheLife({ stale: 3600, revalidate: 7200, expire: 86400 }), a wrong/correct pair for the runtime-API constraint, and a full before/after unstable_cache migration — covering the common cases, matching anchor 5.

5 / 5

Workflow Clarity

The conceptual sequence is clear and well-ordered (enable cacheComponents, classify content into three types, apply the directive, choose profiles, invalidate, migrate), and the wrong/correct examples act as implicit checkpoints. It falls short of anchor 5 because there is no explicit decision guidance for choosing among static/cached/dynamic or among cache profiles, and no validation step for the migration workflow. It is above anchor 3 because the sequence is explicit and the per-section guidance is concrete.

4 / 5

Progressive Disclosure

There are no bundle files (no references/, scripts/, or assets/), so the entire ~410-line reference — including the lengthy migration guide and complete dashboard example — is inlined in SKILL.md with no quick-start/detail split, matching anchor 3 (some structure, content that should be separate is inline) rather than anchor 4. Section headers are well-organized, which keeps it above anchor 2.

3 / 5

Total

16

/

20

Passed

Description

65%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 highly specific, low-conflict description whose keywords closely match what users say when working with Next.js 16 caching. Its main weaknesses are the absence of any 'Use when...' trigger clause and the reliance on topic nouns instead of third-person action statements.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when implementing caching in Next.js 16+, configuring Partial Prerendering (PPR), or migrating from unstable_cache / experimental.ppr.'

Rewrite the feature list as third-person action statements, e.g. 'Configures cacheComponents, applies the use cache directive, sets cacheLife profiles, and invalidates with cacheTag/updateTag/revalidateTag.'

Include natural synonyms users actually say — 'caching', 'revalidateTag', 'ISR', 'partial prerendering', 'unstable_cache migration' — to round out trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain ('Next.js 16 Cache Components') and five concrete API features ('PPR, use cache directive, cacheLife, cacheTag, updateTag'), but they are topic nouns rather than actions — it never states what the skill does with them, so it matches anchor 3 (domain plus concrete items, not comprehensive as actions) rather than anchor 4 (several specific actions).

3 / 5

Completeness

The 'what' is conveyed through a concrete topic list, but the 'when' is entirely absent — there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is above anchor 2 because the domain topics are specific, not vague.

3 / 5

Trigger Term Quality

'Next.js', 'Cache Components', 'PPR', 'use cache', 'cacheLife', 'cacheTag', 'updateTag' are the exact natural terms a user working on Next.js 16 caching would say, but common variations are missing ('caching', 'revalidateTag', 'unstable_cache', 'ISR', 'partial prerendering'), fitting anchor 4 (good coverage, a few natural terms missing) rather than anchor 5.

4 / 5

Distinctiveness Conflict Risk

The description pins a precise framework niche ('Next.js 16 Cache Components') with version-specific API names, giving it clear distinct triggers and minimal conflict risk with other skills — a direct match for anchor 5.

5 / 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
vercel/vercel-plugin
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.