Skills next-cache-components-optimizer
📦

next-cache-components-optimizer

Content revision r1 Safe ⚙️ External commands📁 Filesystem access🔑 Env variables🌐 Network access

Optimize Next.js Cache Component Navigation

Next.js routes can delay their static shell while dynamic data resolves. This skill builds verified instant-navigation tests and guides Cache Components refactors that preserve behavior.

Supports: Claude Codex Code(CC)
🥉 77 Bronze

Install with my Agent

Copy this request to your Agent. It includes the canonical Skill page and manifest.

Agent request
Review the Skillstore skill "next-cache-components-optimizer" from https://skillstore.io/skills/vercel-next-cache-components-optimizer.md and its manifest at https://skillstore.io/api/skills/vercel-next-cache-components-optimizer/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

Your Agent should still show its plan and request any confirmation required by the security policy.

Agent-readable resources

Use these links when an AI agent, crawler, or script needs clean context instead of reading the full page.

Markdown detail GET /skills/vercel-next-cache-components-optimizer.md Signed manifest GET /api/skills/vercel-next-cache-components-optimizer/manifest Signed lockfile GET /api/skills/vercel-next-cache-components-optimizer/lockfile

Test it

Using "next-cache-components-optimizer". Optimize the dashboard route for client-side navigation.

Expected outcome:

  • The dashboard shell waited for a top-level session read.
  • The layout and existing chart skeleton now commit immediately.
  • The locked navigation test fails without the refactor and passes with it.

Using "next-cache-components-optimizer". Add regression coverage for the initial product-page load.

Expected outcome:

The new initial-load check verifies that the product header is served in the static shell while deferred inventory remains gated.

Using "next-cache-components-optimizer". Review whether the search route can become fully instant.

Expected outcome:

The shared shell can commit instantly, but query-specific results require targeted full prefetching or continued streaming.

Security Audit

Safe
v1 • 8/20/2026 Open versioned report

All 158 static alerts are false positives caused by Markdown formatting, fixed relative paths, non-secret deployment flags, and official documentation links. No prompt injection, secret collection, arbitrary process execution, path traversal, or data-exfiltration intent was found. The skill provides legitimate Next.js optimization guidance and explicitly keeps its testing API out of production.

6
Files scanned
1,356
Lines analyzed
0
Review items
0
False positives ignored

Risk Factors

⚙️ External commands (50)
reference/patterns.md:349 reference/patterns.md:341-343 SKILL.md:20 SKILL.md:23 SKILL.md:24 SKILL.md:40 SKILL.md:41 SKILL.md:43 SKILL.md:44 SKILL.md:49 SKILL.md:61 SKILL.md:63 SKILL.md:69 SKILL.md:77 SKILL.md:78 SKILL.md:79 SKILL.md:81 SKILL.md:112 SKILL.md:113 SKILL.md:117-130 SKILL.md:130-140 SKILL.md:140 SKILL.md:142 SKILL.md:143 SKILL.md:145-146 SKILL.md:146-148 SKILL.md:148-149 SKILL.md:149-151 SKILL.md:151-153 SKILL.md:153-156 SKILL.md:156-169 SKILL.md:169-172 SKILL.md:172-175 SKILL.md:175 SKILL.md:180-183 SKILL.md:183-184 SKILL.md:184-186 SKILL.md:186-188 SKILL.md:188-191 SKILL.md:191-192 SKILL.md:192-195 SKILL.md:195-204 SKILL.md:204-207 SKILL.md:207-209 SKILL.md:209-212 SKILL.md:212-213 SKILL.md:213-214 SKILL.md:214-218 SKILL.md:218-219 SKILL.md:219-225
📁 Filesystem access (4)
reference/real-app-patterns.md:79 reference/red-test-robustness.md:142 test-template.md:13 test-template.md:28
🔑 Env variables (14)
rig-template.md:40 rig-template.md:41 rig-template.md:98 rig-template.md:103 rig-template.md:40 rig-template.md:41 rig-template.md:98 rig-template.md:103 SKILL.md:199 SKILL.md:200 SKILL.md:202 SKILL.md:199 SKILL.md:200 SKILL.md:202
🌐 Network access (7)
SKILL.md:41 SKILL.md:156 SKILL.md:301 SKILL.md:348 SKILL.md:349 SKILL.md:375 SKILL.md:472
No confirmed security findings were detected by the latest completed static and semantic audit. This does not prove the skill has no side effects.
Audited by: codex
Share & cite this report

Share the versioned assessment report, neutral badge, embed card, and citations. Skillstore reports evidence without deciding whether this Skill is safe.

Open versioned report
Security Assessment

Copy report link

https://skillstore.io/skills/vercel-next-cache-components-optimizer/audits/1?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown badge

[![Skillstore security assessment](https://skillstore.io/badges/skills/vercel-next-cache-components-optimizer/security.svg)](https://skillstore.io/skills/vercel-next-cache-components-optimizer?utm_source=security_passport_badge)

HTML badge

<a href="https://skillstore.io/skills/vercel-next-cache-components-optimizer?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/vercel-next-cache-components-optimizer/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Embed card

<iframe src="https://skillstore.io/embed/skills/vercel-next-cache-components-optimizer.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
Academic citations (APA · BibTeX · CFF)

APA citation

vercel. (2026). next-cache-components-optimizer security audit report (audit version 1) [Author version unspecified]. Skillstore. https://skillstore.io/skills/vercel-next-cache-components-optimizer/audits/1

BibTeX citation

@techreport{vercel-vercel-next-cache-components-optimizer-2026, author = {vercel}, title = {next-cache-components-optimizer security audit report (audit version 1)}, institution = {Skillstore}, year = {2026}, number = {1}, url = {https://skillstore.io/skills/vercel-next-cache-components-optimizer/audits/1}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "next-cache-components-optimizer security audit report (audit version 1)" version: "unspecified" type: report authors: - name: "vercel" date-released: "2026-08-20" url: "https://skillstore.io/skills/vercel-next-cache-components-optimizer/audits/1" identifiers: - type: other value: "skillstore:vercel-next-cache-components-optimizer:audit:1" description: "Skillstore immutable audit report identifier"

Skillstore Score

Why this score Evidence Confidence: Medium
55
Architecture
85
Maintainability
87
Content
65
Community
83
Spec Compliance

What You Can Build

Fix a blocking route

Identify why a route shell waits for dynamic data, then move blocking work behind focused Suspense boundaries.

Build a reliable test rig

Configure a production-like environment that exposes the testing API only outside production and verifies the deployed revision.

Prevent navigation regressions

Add hard-navigation and soft-navigation checks that prove meaningful shell content commits before deferred data.

Try These Prompts

Check one route 
Review the route [ROUTE]. Confirm the Next.js and Cache Components prerequisites, then explain what prevents its static shell from committing instantly.
Create an instant test 
Create a Playwright instant-navigation test for [ROUTE] using [NAVIGATION TYPE]. Use an existing static shell marker and verify the test cannot pass vacuously.
Optimize and verify 
Optimize [ROUTE] for hard and soft navigation. Reuse existing loading interfaces, preserve behavior, and verify failure without the fix and success with it.
Establish the complete loop 
Discover this repository build and test rig, document its safeguards, optimize [ROUTES] individually, and provide linked evidence for baseline, differential, parity, and final tests.

Best Practices

  • Verify the testing API is enabled for measured builds and disabled for production.
  • Choose a stable synchronous shell marker that is visible to the actual test account.
  • Keep a differential result that fails without the fix and passes with it.

Avoid

  • Do not measure instant navigation with development mode, custom timers, or retries.
  • Do not place one coarse Suspense boundary around the entire route.
  • Do not ship baseline scaffolding or duplicate existing loading interfaces.

Frequently Asked Questions

Which Next.js versions are supported?
The workflow requires Next.js 16.3 or newer with Cache Components enabled.
Can the tests run against next dev?
No. Development mode lacks the production prefetch and locking behavior required for a trustworthy result.
Does the skill support both navigation types?
Yes. It covers initial page loads and client-side Link navigation with separate test-driving methods.
Will it create new loading skeletons?
It first reuses route loading files, colocated skeletons, or existing Suspense fallbacks.
How does it avoid a false passing test?
It establishes an unlocked baseline and can verify that deferred content remains gated while the static shell appears.
Can it optimize every dynamic route completely?
No. Some URL-specific content must stream or use targeted full prefetching with an explicit cost tradeoff.

Developer Details

Author

vercel

License

MIT

Skillstore revision

r1

Version notice

The author did not declare a version.

Repository

https://github.com/vercel/next.js/tree/988a6ab72735d5c61f906d6ea0484930aa496713/skills/next-cache-components-optimizer

Ref

bdb71a4bc34515f37772ae85fd5501f9c2ff33b0

Maintenance freshness

8/20/2026

Usage

0 downloads · 0 views

File structure

📁 reference/

📄 patterns.md

📄 real-app-patterns.md

📄 red-test-robustness.md

📄 rig-template.md

📄 SKILL.md

📄 test-template.md

More from vercel

View all

Related Skills

View all