docs: link the optimizer skill to the insight docs and rework the AI agents skills section - #96032
Merged
Merged
Conversation
aurorascharff
marked this pull request as ready for review
July 21, 2026 22:58
Contributor
Stats from current PR🔴 2 regressions, 2 improvements
📊 All Metrics📖 Metrics GlossaryDev Server Metrics:
Build Metrics:
Change Thresholds:
⚡ Dev Server
📦 Dev Server (Webpack) (Legacy)📦 Dev Server (Webpack)
⚡ Production Builds
📦 Production Builds (Webpack) (Legacy)📦 Production Builds (Webpack)
📦 Bundle SizesBundle Sizes⚡ TurbopackClient Main Bundles
Server Middleware
Build DetailsBuild Manifests
📦 WebpackClient Main Bundles
Polyfills
Pages
Server Edge SSR
Middleware
Build DetailsBuild Manifests
Build Cache
🔄 Shared (bundler-independent)Runtimes
📎 Tarball URLCommit: 84f3516 |
Contributor
Failing test suitesCommit: 84f3516 | About building and testing Next.js
Expand output● Error Overlay for server components compiler errors in pages › importing 'server-only' in pages ● Error Overlay for server components compiler errors in pages › importing 'next/cache' APIs in pages › revalidateTag is not allowed ● Error Overlay for server components compiler errors in pages › importing 'next/cache' APIs in pages › revalidateTag is not allowed
Expand output● tsconfig-path-reloading › tsconfig › should recover from module not found when paths is updated ● tsconfig-path-reloading › tsconfig added after starting dev › should recover from module not found when paths is updated
Expand output● app dir - navigation › hash › should scroll to the specified hash |
Contributor
There was a problem hiding this comment.
Pull request overview
This PR streamlines the next-cache-components-optimizer skill docs by removing embedded “how-to” content and replacing it with links to the canonical Next.js documentation, while also expanding the AI agents guide to show how to install/use each skill.
Changes:
- Replace large in-repo fix “recipes” with concise link-based references to Next.js docs/insights.
- Update wording/terminology around instant navigation (e.g. App Shell vs static shell) and prerequisites.
- Expand
ai-agentsdocumentation to include per-skill install commands and example prompts.
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| skills/next-cache-components-optimizer/test-template.md | Updates soft-navigation description to refer to the prefetched App Shell. |
| skills/next-cache-components-optimizer/SKILL.md | Tightens prerequisites and points readers to canonical docs + related adoption skill. |
| skills/next-cache-components-optimizer/reference/real-app-patterns.md | Replaces detailed devtools instructions with doc links; refreshes blocker references. |
| skills/next-cache-components-optimizer/reference/patterns.md | Collapses detailed before/after patterns into a table of doc links + runtime-prefetching notes. |
| docs/01-app/02-guides/ai-agents.mdx | Reworks the skills section into per-skill subsections with install + prompt examples. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
gaojude
approved these changes
Jul 21, 2026
aurorascharff
marked this pull request as draft
July 21, 2026 23:23
aurorascharff
marked this pull request as ready for review
July 21, 2026 23:28
aurorascharff
changed the title
icyJoseph
approved these changes
Jul 21, 2026
aurorascharff
merged commit Jul 21, 2026
ea69691
into
jude/instant-nav-skill
110 of 113 checks passed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Stacked on #94721. Two docs-only changes.
next-cache-components-optimizerskill — stop re-implementing what the docs own.kind: insightpages that already surface in the build output (and the dev overlay) with adocs/messages/<slug>link, so the skill now points at them instead of carrying a before→after table. Deletedreference/patterns.mdand folded the parts the insights don't cover into the D (FIX) phase: client-nav boundary placement, keep-the-LCP-in-shell, "a green check isn't always instant," and the runtime-prefetch escape hatch with itsinstant()-specific gotchas.next devNavigation Inspector observation and the staleinstant = true"regression marker" edge case (validation runs by default, so the opt-in was pointless). Detection stays on the build (--debug-prerenderfor the full frame,--debug-build-paths "app/<route>/**"to scope it).instant()comes from@next/playwright.AI agents guide (
ai-agents.mdx). Reworked the skills table into per-skill sections, each with an install command and a copyable agent prompt (matching the 16.3 AI blog). Plain headings with the GitHub link in the description, per review.Verification
Docs-only; no build/test. Rendered the AI agents guide locally against the docs site to confirm it renders.