Drive Next.js routes to instant navigation
Test-driven optimization loop that maximizes each route's static shell and guards it with an instant() e2e test
- What
- Test-driven optimization loop that maximizes each route's static shell and guards it with an instant() e2e test
- Cost
- Free
- Needs
- Next.js 16.3+ with cacheComponents enabled; a rig able to run a production-like build plus Playwright (@next/playwright on the same release line as next)
- Install
- Copy the installer prompt below into your Muse — your agent does the rest.
Curated by Skill Harbor — an agentic optimization loop for making a Next.js route's navigation instant under Cache Components / PPR, on both initial load and client-side navigation: encode the goal as a failing `@next/playwright` `instant()` end-to-end test, work the phases in order (maximize the static shell, fix whichever Suspense boundary keeps content out of it), and ship the test as the regression guard. Includes before/after fix recipes and a clear warning about the empty-shell failure mode (an `instant()` pass is satisfied by a blank fallback, so the workflow enforces a non-blank bar by judgment). By @vercel, listed here with credit to its creator. Honest caveats: requires Next.js 16.3+ with cacheComponents and a rig that can run a production-like build plus Playwright — one route at a time, and the loop is the deliverable, not any single fix. Discovered via skills.sh. Skill Harbor never reviews the code, review it yourself before use.
Version:
Quick answer
Drive Next.js routes to instant navigation is a free optimization loop for making Next.js navigation instant under Cache Components and PPR, on load and navigation. It encodes the goal as a failing instant test, works the phases by maximizing the shell and fixing Suspense boundary keeps content out of it, and ships the test as the guard, with recipes.
Install
Copy the install package below, then paste it into Muse🧪 Install ran in our test sandbox and failed · Nov 18, 2026 · Needs pnpm, npm cannot install it📌 Pinned version: commit 5da8ef1Step 0 — before installing anything: read this install prompt, summarize in a few lines what this build does and what installing it involves, then ask me to confirm before you proceed. Prerequisites: Next.js 16.3+ with cacheComponents enabled; a rig able to run a production-like build plus Playwright (@next/playwright on the same release line as next) Install "Drive Next.js routes to instant navigation" for me. Give my agent the test-driven Cache Components optimization loop — encode instant navigation as a failing instant() e2e test, maximize the route's static shell phase by phase, fix the Suspense boundaries that keep content out, and ship the test as the regression guard Repository: https://raw.githubusercontent.com/vercel/next.js/5da8ef12bc6b4156dd490e58e3878e06fd7f4472/skills/next-cache-components-optimizer/SKILL.md Pinned version: install the code at commit 5da8ef12bc6b4156dd490e58e3878e06fd7f4472 exactly (Skill Harbor tested this version). Do not substitute a newer version. If this commit is unreachable, stop and tell me. 1. Fetch the SKILL.md file for the vercel-next.js-next-cache-components-optimizer skill from the repository into a temporary folder 2. Safety check: review the SKILL.md for anything suspicious (unexpected network calls, shell commands, credential harvesting). This repo should contain zero secrets in code, credentials only via the secure vault, allowed hosts declared in the SKILL.md. Verify that holds here; STOP on any red flag and tell me. 3. Install it as a skill: copy SKILL.md into the agent's skills directory, in a folder named "vercel-next.js-next-cache-components-optimizer". 4. Verify with no network calls: frontmatter valid, files in place. 5. Report what was installed, where, and what I still need to do myself (e.g. confirm cacheComponents is on and that I can run next build plus the @next/playwright instant() tests in my rig). GitHub is optional: if I have a GitHub account or the gh CLI, you may use it; otherwise public access is fine. Never require it unless it's in the prerequisites above. Rules: don't touch anything outside the temp folder and the install target. If anything looks off, stop and ask me.
Saved to your recent installs. Find it anytime on /connect.
🔒 Security, provenance and what this touches
The install prompt below already includes the vetting steps: your agent follows the community checklist before installing anything with executable code. Want more?
Verification certificate
Dated facts about what was checked for this listing, and how. This is not a safety certification.
- Pinned version
- 5da8ef1 · 2026-10-13
- Sandbox install test
- Install ran in our test sandbox and failed · Nov 18, 2026 — Needs pnpm, npm cannot install it · Observed during the install test: registry.npmjs.org
- Creator identity
- Not verified
- Fingerprint watch
- Last checked · Nov 19, 2026 : no change detected in the files linked by this install prompt
- Install prompt analysis
- 2026-10-13 : No commands, network calls, packages, file writes or API keys detected.
Skill Harbor never reviews the code of a listed skill. These are dated facts about the install prompt and our install test, not a safety certification. Review a skill yourself before you install it. How we verify
Questions
How do I install a skill?
Every product page includes a copy-paste install prompt. Paste it into your Muse and it sets the skill up for you — no manual configuration.
Where does my money go?
Straight to the seller. Skill Harbor never processes payments: checkout happens on the seller’s own page, usually Stripe.
What does the ✓ next to a creator’s name mean?
It means we confirmed the identity of the person behind the listing. It says nothing about the code itself — always check a skill before installing it.