[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M76W117DN15YREG6FAG5589T":3,"skill-same:01M76W117DN15YREG6FAG5589T":246},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M76W117DN15YREG6FAG5589T","nextjs",null,"Next.js 16 App Router performance, caching, server components, server actions, routing, and codebase-hygiene best practices — plus a category-major review\u002Frefactor algorithm with codebase-level (remove\u002Fdedup\u002Freuse) findings. This skill should be used when writing Next.js 16 App Router code, configuring caching with 'use cache', building Server Components, setting up parallel\u002Fintercepting routes, configuring next.config.js OR proxy.ts, OR auditing\u002Frefactoring a Next.js codebase (single file or whole repo). This skill does NOT cover generic React 19 patterns (use react skill) or non-Next.js server rendering.","ngxccc\u002Fagent-skills-kit","ngxccc","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F163379246?v=4","01M758XVG64QK26AGK0WKB26TB","Ngoc Tran","01M758XVHB8J6MHV0YTBVDBXCA",0,"MIT","https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: nextjs\ndescription: Next.js 16 App Router performance, caching, server components, server actions, routing, and codebase-hygiene best practices — plus a category-major review\u002Frefactor algorithm with codebase-level (remove\u002Fdedup\u002Freuse) findings. This skill should be used when writing Next.js 16 App Router code, configuring caching with 'use cache', building Server Components, setting up parallel\u002Fintercepting routes, configuring next.config.js OR proxy.ts, OR auditing\u002Frefactoring a Next.js codebase (single file or whole repo). This skill does NOT cover generic React 19 patterns (use react skill) or non-Next.js server rendering.\n---\n\n# Next.js 16 App Router Best Practices\n\nComprehensive Next.js 16 App Router guide for AI agents. Contains **45 rules across 9 categories**, prioritized by impact from critical (build optimization, caching strategy) through to cross-cutting codebase hygiene (dedup, dead routes, boundary coherence). Reflects Next.js 16 changes: `'use cache'` directive replacing implicit caching, `revalidateTag(tag, cacheLife)` requirement, `proxy.ts` replacing `middleware.ts`, Turbopack persistent caching, App Router conventions.\n\nRule files describe **pattern shapes** (not API names) and open with a **\"Shapes to recognize\"** section listing 2–4 syntactic disguises the same break can wear. **Selected high-value rules** (those whose disguises are most common in practice — `'use cache'`, parallel-fetching, dynamic-imports, server-action-forms, client-boundary, server-vs-client-fetching) include an extra concrete **\"In disguise\"** incorrect\u002Fcorrect example pair to teach pattern detection beyond the grep-friendly cases.\n\n## When to Apply\n\n- Writing new Next.js 16 App Router code\n- **Auditing or modernizing a Next.js codebase** — single file, PR, or whole repo (see [`references\u002F_review-algorithm.md`](references\u002F_review-algorithm.md))\n- Migrating from Next.js 15 to 16 (implicit caching → `'use cache'`, `middleware.ts` → `proxy.ts`, `revalidateTag` single-arg → with `cacheLife`)\n- Configuring caching strategies with `'use cache'`, `unstable_cache`, `revalidateTag`, `revalidatePath`\n- Implementing Server Components and parallel\u002Fcolocated data fetching\n- Setting up parallel routes, intercepting routes, prefetching, `proxy.ts`\n- Creating Server Actions for form handling and mutations\n- Tuning `'use client'` boundaries to minimize client bundle\n- **Finding codebase-level issues** that single-file rules can't see: duplicated server fetchers, near-duplicate routes\u002Flayouts, dead routes, `'use client'` propagation across the route tree, prop-shape drift (see Category 9)\n\n## How to Review or Refactor a Codebase\n\n**When the user asks to review, refactor, modernize, or audit Next.js code — single file or whole repo — follow [`references\u002F_review-algorithm.md`](references\u002F_review-algorithm.md). Do not improvise.**\n\nFour non-negotiables from that doc:\n\n1. **Two modes — never refuse a whole-repo audit.** Pick **Mode A** (scoped, ≤~20 files) or **Mode B** (whole-tree: inventory pass + targeted sweeps + full Category 9).\n2. **Judgment over grep.** Each rule names a _pattern shape_, not a syntactic marker. Read each rule's **Shapes to recognize** section before sweeping — grep finds the easy violations and misses the high-value ones (a layout marked `'use client'` for one button; TanStack Query fetching initial page data; a route handler doing the work of a Server Action; a hand-rolled cache layer mimicking `'use cache'`; sequential fetches hidden across parent\u002Fchild Server Components).\n3. **Category-major, not file-major — with forcing functions.** Sweep one category at a time across all in-scope files in priority order (CRITICAL → … → CROSS-CUTTING). The algorithm requires a **scope declaration**, **per-category progress lines**, and a final **coverage table** (category × file\u002Fbucket, cells ∈ `{clean, N findings, n\u002Fa}`). A missing category in the output is _immediately visible_.\n4. **Codebase-level findings come from Category 9.** Single-file rules can't tell you \"these two routes should be one\" or \"this server action is dead.\" Category 9 (Codebase Hygiene) sweeps the full inventory at the end and produces remove \u002F dedup \u002F reuse \u002F consolidate findings.\n\nSingle-file ad-hoc questions (\"is this caching strategy right?\") can go straight to the relevant rule. The algorithm exists for the multi-file and whole-repo cases.\n\n## Rule Categories\n\n| #   | Category                          | Impact         | Rules | Key Topics                                                                                                  |\n| --- | --------------------------------- | -------------- | ----- | ----------------------------------------------------------------------------------------------------------- |\n| 1   | Build & Bundle Optimization       | CRITICAL       | 5     | Turbopack, optimizePackageImports, dynamic imports, barrel files, serverExternalPackages                    |\n| 2   | Caching Strategy                  | CRITICAL       | 6     | `'use cache'`, `revalidateTag`+cacheLife, fetch options, segment config                                     |\n| 3   | Server Components & Data Fetching | HIGH           | 6     | Parallel fetching, streaming, colocation, preload, no-client-fetch, error handling                          |\n| 4   | Routing & Navigation              | HIGH           | 5     | Parallel routes, intercepting routes, prefetching, `proxy.ts`, `notFound()`                                 |\n| 5   | Server Actions & Mutations        | MEDIUM-HIGH    | 5     | Server actions, useFormStatus, action-result errors, useOptimistic, revalidation                            |\n| 6   | Streaming & Loading States        | MEDIUM         | 5     | Suspense placement, loading.tsx, error.tsx, skeleton matching, nested Suspense                              |\n| 7   | Metadata & SEO                    | MEDIUM         | 4     | generateMetadata, sitemap.ts, robots.ts, opengraph-image.tsx                                                |\n| 8   | Client Components                 | LOW-MEDIUM     | 4     | `'use client'` boundary, children pattern, hydration mismatch, next\u002Fscript                                  |\n| 9   | **Codebase Hygiene**              | **LOW-MEDIUM** | **5** | **Dedup server fetchers, route consolidation, dead routes\u002Factions, `'use client'` propagation, prop drift** |\n\n## Quick Reference\n\n**Critical patterns** — get these right first:\n\n- Add `'use cache'` to Server Components\u002Ffunctions whose results should be cached (Next.js 16 dropped implicit fetch caching)\n- Call `revalidateTag(tag, cacheLife)` with a profile — never the one-arg API\n- Configure `optimizePackageImports` for icon\u002Futility libraries with flat-export surfaces\n- Don't disable Turbopack persistent caching\n- Wrap `\u003Cform action={serverAction}>` instead of POST-to-`\u002Fapi\u002F...`\n\n**Next.js 16 idioms (do NOT generate Next.js 15 patterns):**\n\n- `proxy.ts` (Node runtime) — not `middleware.ts` (Edge)\n- Explicit `'use cache'` — not implicit fetch caching\n- `revalidateTag(tag, cacheLife)` — not single-arg `revalidateTag(tag)`\n- Server Action + `useActionState` — not client `fetch` + `useState`\n- `app\u002Fsitemap.ts` — not hand-maintained `public\u002Fsitemap.xml`\n\n**Common single-file mistakes** — avoid these anti-patterns:\n\n- Sequential `await` for independent data (use `Promise.all` or preload)\n- `useEffect` + `fetch` in a Client Component for initial page data\n- `'use client'` at the layout level for one interactive button\n- Missing `revalidatePath`\u002F`revalidateTag` after a mutating Server Action\n- Skeletons that don't match content dimensions (CLS hit)\n\n**Codebase-level patterns** — surface these in Category 9 sweeps:\n\n- 2+ Server Components hitting the same upstream with drifting cache policies — **extract** to a shared cached fetcher\n- 2+ near-duplicate routes\u002Flayouts that should be one with a variant or dynamic segment — **consolidate**\n- Routes \u002F route handlers \u002F Server Actions with no inbound traffic for 90+ days — **delete** (after analytics check)\n- `'use client'` propagating up the route tree because of one interactive leaf — **demote** layouts\u002Fparents to Server Components, leave a client island\n- Same concept under different route-param\u002Fsearch-param\u002Fprop names — **converge** on a canonical name (watch out for SEO redirects)\n\n## Table of Contents\n\n1. [Build & Bundle Optimization](references\u002F_sections.md#1-build--bundle-optimization) — **CRITICAL**\n   - 1.1 [Import from the source module, not from a barrel `index.ts`](references\u002Fbuild-barrel-files.md) — CRITICAL (2-10x faster dev startup)\n   - 1.2 [Declare package-flat-export libraries in `optimizePackageImports`](references\u002Fbuild-optimize-package-imports.md) — CRITICAL (200-800ms faster imports, 50-80% smaller bundles)\n   - 1.3 [Mark Node packages with native bindings as `serverExternalPackages`](references\u002Fbuild-external-packages.md) — HIGH\n   - 1.4 [Don't disable Turbopack's persistent caching](references\u002Fbuild-turbopack-config.md) — CRITICAL (5-10x faster cold starts)\n   - 1.5 [Split heavy components into separately loaded chunks](references\u002Fbuild-dynamic-imports.md) — CRITICAL (30-70% smaller initial bundle)\n2. [Caching Strategy](references\u002F_sections.md#2-caching-strategy) — **CRITICAL**\n   - 2.1 [Make every server `fetch` declare its caching intent](references\u002Fcache-fetch-options.md) — HIGH\n   - 2.2 [Declare route-level caching via segment-config exports](references\u002Fcache-segment-config.md) — MEDIUM-HIGH\n   - 2.3 [Mark cacheable Server Components\u002Ffunctions explicitly with `'use cache'`](references\u002Fcache-use-cache-directive.md) — CRITICAL\n   - 2.4 [Call `revalidateTag(tag, cacheLife)` with a profile](references\u002Fcache-revalidate-tag.md) — CRITICAL\n   - 2.5 [Every Server Action that mutates must invalidate the routes\u002Ftags that surface it](references\u002Fcache-revalidate-path.md) — HIGH\n   - 2.6 [Wrap per-request fetchers with React `cache()` for dedup](references\u002Fcache-react-cache.md) — HIGH\n3. [Server Components & Data Fetching](references\u002F_sections.md#3-server-components--data-fetching) — **HIGH**\n   - 3.1 [Independent server fetches run concurrently — sequential `await` is a waterfall](references\u002Fserver-parallel-fetching.md) — HIGH\n   - 3.2 [Wrap each independently-paced async leaf in its own `\u003CSuspense>`](references\u002Fserver-component-streaming.md) — HIGH\n   - 3.3 [Each Server Component fetches the data it renders](references\u002Fserver-data-colocation.md) — HIGH\n   - 3.4 [Trigger critical data fetches at the top via a `preload` call](references\u002Fserver-preload-pattern.md) — MEDIUM-HIGH\n   - 3.5 [Initial page data lands in HTML via a Server Component — never `useEffect`+`fetch`](references\u002Fserver-avoid-client-fetching.md) — MEDIUM-HIGH\n   - 3.6 [Contain async failures via `error.tsx` or `ErrorBoundary`](references\u002Fserver-error-handling.md) — MEDIUM\n4. [Routing & Navigation](references\u002F_sections.md#4-routing--navigation) — **HIGH**\n   - 4.1 [Multi-region layouts use parallel-route slots](references\u002Froute-parallel-routes.md) — HIGH\n   - 4.2 [Modal\u002Flightbox detail views use intercepting routes](references\u002Froute-intercepting-routes.md) — HIGH\n   - 4.3 [Tune `\u003CLink prefetch>` to traffic likelihood](references\u002Froute-prefetching.md) — MEDIUM-HIGH\n   - 4.4 [Network-boundary logic lives in `proxy.ts` — not `middleware.ts`](references\u002Froute-proxy-ts.md) — MEDIUM-HIGH\n   - 4.5 [Missing dynamic resource calls `notFound()` for real HTTP 404](references\u002Froute-not-found.md) — MEDIUM\n5. [Server Actions & Mutations](references\u002F_sections.md#5-server-actions--mutations) — **MEDIUM-HIGH**\n   - 5.1 [Mutations from forms run through Server Actions — not API routes + client `fetch`](references\u002Faction-server-action-forms.md) — MEDIUM-HIGH\n   - 5.2 [Submit buttons read parent-form pending state from `useFormStatus`](references\u002Faction-pending-states.md) — MEDIUM-HIGH\n   - 5.3 [Server Actions return a typed error\u002Fstate result — never throw silently](references\u002Faction-error-handling.md) — MEDIUM-HIGH\n   - 5.4 [Mutations with predictable UI outcomes apply optimistically](references\u002Faction-optimistic-updates.md) — MEDIUM\n   - 5.5 [Every Server Action invalidates the routes\u002Ftags that surface its data](references\u002Faction-revalidation.md) — MEDIUM\n6. [Streaming & Loading States](references\u002F_sections.md#6-streaming--loading-states) — **MEDIUM**\n   - 6.1 [Place Suspense around independently-paced subtrees](references\u002Fstream-suspense-boundaries.md) — MEDIUM\n   - 6.2 [Every route has a `loading.tsx` adjacent to its `page.tsx`](references\u002Fstream-loading-tsx.md) — MEDIUM\n   - 6.3 [Every route has an `error.tsx` next to it](references\u002Fstream-error-tsx.md) — MEDIUM\n   - 6.4 [Skeletons match the dimensions of the content they replace](references\u002Fstream-skeleton-matching.md) — MEDIUM\n   - 6.5 [Nest Suspense when content has a natural reveal order](references\u002Fstream-nested-suspense.md) — LOW-MEDIUM\n7. [Metadata & SEO](references\u002F_sections.md#7-metadata--seo) — **MEDIUM**\n   - 7.1 [Dynamic routes export `generateMetadata` for per-resource SEO](references\u002Fmeta-generate-metadata.md) — MEDIUM\n   - 7.2 [Generate sitemaps from actual data — never hand-maintain XML](references\u002Fmeta-sitemap.md) — MEDIUM\n   - 7.3 [Make crawl rules explicit via `app\u002Frobots.ts` and per-page metadata](references\u002Fmeta-robots.md) — MEDIUM\n   - 7.4 [Generate per-page OG images via `opengraph-image.tsx`](references\u002Fmeta-opengraph-images.md) — LOW-MEDIUM\n8. [Client Components](references\u002F_sections.md#8-client-components) — **LOW-MEDIUM**\n   - 8.1 [Push `'use client'` down to the interactive leaf](references\u002Fclient-use-client-boundary.md) — LOW-MEDIUM\n   - 8.2 [Server content reaches inside a Client Component via `children`](references\u002Fclient-children-pattern.md) — LOW-MEDIUM\n   - 8.3 [SSR and client initial render must produce identical HTML](references\u002Fclient-hydration-mismatch.md) — LOW-MEDIUM\n   - 8.4 [Wrap third-party scripts in `next\u002Fscript` with the right `strategy`](references\u002Fclient-third-party-scripts.md) — LOW-MEDIUM\n9. [Codebase Hygiene](references\u002F_sections.md#9-codebase-hygiene) — **CROSS-CUTTING** (multi-file findings; required for whole-repo audits)\n   - 9.1 [Extract duplicated server-side fetchers\u002Factions into a shared module](references\u002Fcross-extract-shared-logic.md) — HIGH\n   - 9.2 [Consolidate near-duplicate routes\u002Flayouts\u002Fcomponents](references\u002Fcross-component-consolidation.md) — HIGH\n   - 9.3 [Delete unreachable routes, unused Server Actions, orphan utilities](references\u002Fcross-dead-code.md) — MEDIUM-HIGH\n   - 9.4 [Audit `'use client'` placement across the route tree](references\u002Fcross-boundary-coherence.md) — HIGH\n   - 9.5 [Converge on canonical names for the same concept across routes\u002Fcomponents](references\u002Fcross-prop-shape-drift.md) — MEDIUM-HIGH\n\n## References\n\n1. [Next.js Documentation](https:\u002F\u002Fnextjs.org\u002Fdocs)\n2. [Next.js 16 Release Notes](https:\u002F\u002Fnextjs.org\u002Fblog\u002Fnext-16)\n3. [React Documentation](https:\u002F\u002Freact.dev)\n4. [Vercel Engineering Blog](https:\u002F\u002Fvercel.com\u002Fblog)\n\n## Related Skills\n\n- For React 19 fundamentals (concurrent rendering, hooks, components), see `react` skill\n- For client-side form handling, see `react-hook-form` skill\n- For client data caching with TanStack Query, see `tanstack-query` skill\n\n## Full Compiled Document\n\nFor the complete guide with all rules expanded: `AGENTS.md`\n","# Next.js 16 App Router Best Practices\n\nComprehensive Next.js 16 App Router guide for AI agents. Contains **45 rules across 9 categories**, prioritized by impact from critical (build optimization, caching strategy) through to cross-cutting codebase hygiene (dedup, dead routes, boundary coherence). Reflects Next.js 16 changes: `'use cache'` directive replacing implicit caching, `revalidateTag(tag, cacheLife)` requirement, `proxy.ts` replacing `middleware.ts`, Turbopack persistent caching, App Router conventions.\n\nRule files describe **pattern shapes** (not API names) and open with a **\"Shapes to recognize\"** section listing 2–4 syntactic disguises the same break can wear. **Selected high-value rules** (those whose disguises are most common in practice — `'use cache'`, parallel-fetching, dynamic-imports, server-action-forms, client-boundary, server-vs-client-fetching) include an extra concrete **\"In disguise\"** incorrect\u002Fcorrect example pair to teach pattern detection beyond the grep-friendly cases.\n\n## When to Apply\n\n- Writing new Next.js 16 App Router code\n- **Auditing or modernizing a Next.js codebase** — single file, PR, or whole repo (see [`references\u002F_review-algorithm.md`](references\u002F_review-algorithm.md))\n- Migrating from Next.js 15 to 16 (implicit caching → `'use cache'`, `middleware.ts` → `proxy.ts`, `revalidateTag` single-arg → with `cacheLife`)\n- Configuring caching strategies with `'use cache'`, `unstable_cache`, `revalidateTag`, `revalidatePath`\n- Implementing Server Components and parallel\u002Fcolocated data fetching\n- Setting up parallel routes, intercepting routes, prefetching, `proxy.ts`\n- Creating Server Actions for form handling and mutations\n- Tuning `'use client'` boundaries to minimize client bundle\n- **Finding codebase-level issues** that single-file rules can't see: duplicated server fetchers, near-duplicate routes\u002Flayouts, dead routes, `'use client'` propagation across the route tree, prop-shape drift (see Category 9)\n\n## How to Review or Refactor a Codebase\n\n**When the user asks to review, refactor, modernize, or audit Next.js code — single file or whole repo — follow [`references\u002F_review-algorithm.md`](references\u002F_review-algorithm.md). Do not improvise.**\n\nFour non-negotiables from that doc:\n\n1. **Two modes — never refuse a whole-repo audit.** Pick **Mode A** (scoped, ≤~20 files) or **Mode B** (whole-tree: inventory pass + targeted sweeps + full Category 9).\n2. **Judgment over grep.** Each rule names a _pattern shape_, not a syntactic marker. Read each rule's **Shapes to recognize** section before sweeping — grep finds the easy violations and misses the high-value ones (a layout marked `'use client'` for one button; TanStack Query fetching initial page data; a route handler doing the work of a Server Action; a hand-rolled cache layer mimicking `'use cache'`; sequential fetches hidden across parent\u002Fchild Server Components).\n3. **Category-major, not file-major — with forcing functions.** Sweep one category at a time across all in-scope files in priority order (CRITICAL → … → CROSS-CUTTING). The algorithm requires a **scope declaration**, **per-category progress lines**, and a final **coverage table** (category × file\u002Fbucket, cells ∈ `{clean, N findings, n\u002Fa}`). A missing category in the output is _immediately visible_.\n4. **Codebase-level findings come from Category 9.** Single-file rules can't tell you \"these two routes should be one\" or \"this server action is dead.\" Category 9 (Codebase Hygiene) sweeps the full inventory at the end and produces remove \u002F dedup \u002F reuse \u002F consolidate findings.\n\nSingle-file ad-hoc questions (\"is this caching strategy right?\") can go straight to the relevant rule. The algorithm exists for the multi-file and whole-repo cases.\n\n## Rule Categories\n\n| #   | Category                          | Impact         | Rules | Key Topics                                                                                                  |\n| --- | --------------------------------- | -------------- | ----- | ----------------------------------------------------------------------------------------------------------- |\n| 1   | Build & Bundle Optimization       | CRITICAL       | 5     | Turbopack, optimizePackageImports, dynamic imports, barrel files, serverExternalPackages                    |\n| 2   | Caching Strategy                  | CRITICAL       | 6     | `'use cache'`, `revalidateTag`+cacheLife, fetch options, segment config                                     |\n| 3   | Server Components & Data Fetching | HIGH           | 6     | Parallel fetching, streaming, colocation, preload, no-client-fetch, error handling                          |\n| 4   | Routing & Navigation              | HIGH           | 5     | Parallel routes, intercepting routes, prefetching, `proxy.ts`, `notFound()`                                 |\n| 5   | Server Actions & Mutations        | MEDIUM-HIGH    | 5     | Server actions, useFormStatus, action-result errors, useOptimistic, revalidation                            |\n| 6   | Streaming & Loading States        | MEDIUM         | 5     | Suspense placement, loading.tsx, error.tsx, skeleton matching, nested Suspense                              |\n| 7   | Metadata & SEO                    | MEDIUM         | 4     | generateMetadata, sitemap.ts, robots.ts, opengraph-image.tsx                                                |\n| 8   | Client Components                 | LOW-MEDIUM     | 4     | `'use client'` boundary, children pattern, hydration mismatch, next\u002Fscript                                  |\n| 9   | **Codebase Hygiene**              | **LOW-MEDIUM** | **5** | **Dedup server fetchers, route consolidation, dead routes\u002Factions, `'use client'` propagation, prop drift** |\n\n## Quick Reference\n\n**Critical patterns** — get these right first:\n\n- Add `'use cache'` to Server Components\u002Ffunctions whose results should be cached (Next.js 16 dropped implicit fetch caching)\n- Call `revalidateTag(tag, cacheLife)` with a profile — never the one-arg API\n- Configure `optimizePackageImports` for icon\u002Futility libraries with flat-export surfaces\n- Don't disable Turbopack persistent caching\n- Wrap `\u003Cform action={serverAction}>` instead of POST-to-`\u002Fapi\u002F...`\n\n**Next.js 16 idioms (do NOT generate Next.js 15 patterns):**\n\n- `proxy.ts` (Node runtime) — not `middleware.ts` (Edge)\n- Explicit `'use cache'` — not implicit fetch caching\n- `revalidateTag(tag, cacheLife)` — not single-arg `revalidateTag(tag)`\n- Server Action + `useActionState` — not client `fetch` + `useState`\n- `app\u002Fsitemap.ts` — not hand-maintained `public\u002Fsitemap.xml`\n\n**Common single-file mistakes** — avoid these anti-patterns:\n\n- Sequential `await` for independent data (use `Promise.all` or preload)\n- `useEffect` + `fetch` in a Client Component for initial page data\n- `'use client'` at the layout level for one interactive button\n- Missing `revalidatePath`\u002F`revalidateTag` after a mutating Server Action\n- Skeletons that don't match content dimensions (CLS hit)\n\n**Codebase-level patterns** — surface these in Category 9 sweeps:\n\n- 2+ Server Components hitting the same upstream with drifting cache policies — **extract** to a shared cached fetcher\n- 2+ near-duplicate routes\u002Flayouts that should be one with a variant or dynamic segment — **consolidate**\n- Routes \u002F route handlers \u002F Server Actions with no inbound traffic for 90+ days — **delete** (after analytics check)\n- `'use client'` propagating up the route tree because of one interactive leaf — **demote** layouts\u002Fparents to Server Components, leave a client island\n- Same concept under different route-param\u002Fsearch-param\u002Fprop names — **converge** on a canonical name (watch out for SEO redirects)\n\n## Table of Contents\n\n1. [Build & Bundle Optimization](references\u002F_sections.md#1-build--bundle-optimization) — **CRITICAL**\n   - 1.1 [Import from the source module, not from a barrel `index.ts`](references\u002Fbuild-barrel-files.md) — CRITICAL (2-10x faster dev startup)\n   - 1.2 [Declare package-flat-export libraries in `optimizePackageImports`](references\u002Fbuild-optimize-package-imports.md) — CRITICAL (200-800ms faster imports, 50-80% smaller bundles)\n   - 1.3 [Mark Node packages with native bindings as `serverExternalPackages`](references\u002Fbuild-external-packages.md) — HIGH\n   - 1.4 [Don't disable Turbopack's persistent caching](references\u002Fbuild-turbopack-config.md) — CRITICAL (5-10x faster cold starts)\n   - 1.5 [Split heavy components into separately loaded chunks](references\u002Fbuild-dynamic-imports.md) — CRITICAL (30-70% smaller initial bundle)\n2. [Caching Strategy](references\u002F_sections.md#2-caching-strategy) — **CRITICAL**\n   - 2.1 [Make every server `fetch` declare its caching intent](references\u002Fcache-fetch-options.md) — HIGH\n   - 2.2 [Declare route-level caching via segment-config exports](references\u002Fcache-segment-config.md) — MEDIUM-HIGH\n   - 2.3 [Mark cacheable Server Components\u002Ffunctions explicitly with `'use cache'`](references\u002Fcache-use-cache-directive.md) — CRITICAL\n   - 2.4 [Call `revalidateTag(tag, cacheLife)` with a profile](references\u002Fcache-revalidate-tag.md) — CRITICAL\n   - 2.5 [Every Server Action that mutates must invalidate the routes\u002Ftags that surface it](references\u002Fcache-revalidate-path.md) — HIGH\n   - 2.6 [Wrap per-request fetchers with React `cache()` for dedup](references\u002Fcache-react-cache.md) — HIGH\n3. [Server Components & Data Fetching](references\u002F_sections.md#3-server-components--data-fetching) — **HIGH**\n   - 3.1 [Independent server fetches run concurrently — sequential `await` is a waterfall](references\u002Fserver-parallel-fetching.md) — HIGH\n   - 3.2 [Wrap each independently-paced async leaf in its own `\u003CSuspense>`](references\u002Fserver-component-streaming.md) — HIGH\n   - 3.3 [Each Server Component fetches the data it renders](references\u002Fserver-data-colocation.md) — HIGH\n   - 3.4 [Trigger critical data fetches at the top via a `preload` call](references\u002Fserver-preload-pattern.md) — MEDIUM-HIGH\n   - 3.5 [Initial page data lands in HTML via a Server Component — never `useEffect`+`fetch`](references\u002Fserver-avoid-client-fetching.md) — MEDIUM-HIGH\n   - 3.6 [Contain async failures via `error.tsx` or `ErrorBoundary`](references\u002Fserver-error-handling.md) — MEDIUM\n4. [Routing & Navigation](references\u002F_sections.md#4-routing--navigation) — **HIGH**\n   - 4.1 [Multi-region layouts use parallel-route slots](references\u002Froute-parallel-routes.md) — HIGH\n   - 4.2 [Modal\u002Flightbox detail views use intercepting routes](references\u002Froute-intercepting-routes.md) — HIGH\n   - 4.3 [Tune `\u003CLink prefetch>` to traffic likelihood](references\u002Froute-prefetching.md) — MEDIUM-HIGH\n   - 4.4 [Network-boundary logic lives in `proxy.ts` — not `middleware.ts`](references\u002Froute-proxy-ts.md) — MEDIUM-HIGH\n   - 4.5 [Missing dynamic resource calls `notFound()` for real HTTP 404](references\u002Froute-not-found.md) — MEDIUM\n5. [Server Actions & Mutations](references\u002F_sections.md#5-server-actions--mutations) — **MEDIUM-HIGH**\n   - 5.1 [Mutations from forms run through Server Actions — not API routes + client `fetch`](references\u002Faction-server-action-forms.md) — MEDIUM-HIGH\n   - 5.2 [Submit buttons read parent-form pending state from `useFormStatus`](references\u002Faction-pending-states.md) — MEDIUM-HIGH\n   - 5.3 [Server Actions return a typed error\u002Fstate result — never throw silently](references\u002Faction-error-handling.md) — MEDIUM-HIGH\n   - 5.4 [Mutations with predictable UI outcomes apply optimistically](references\u002Faction-optimistic-updates.md) — MEDIUM\n   - 5.5 [Every Server Action invalidates the routes\u002Ftags that surface its data](references\u002Faction-revalidation.md) — MEDIUM\n6. [Streaming & Loading States](references\u002F_sections.md#6-streaming--loading-states) — **MEDIUM**\n   - 6.1 [Place Suspense around independently-paced subtrees](references\u002Fstream-suspense-boundaries.md) — MEDIUM\n   - 6.2 [Every route has a `loading.tsx` adjacent to its `page.tsx`](references\u002Fstream-loading-tsx.md) — MEDIUM\n   - 6.3 [Every route has an `error.tsx` next to it](references\u002Fstream-error-tsx.md) — MEDIUM\n   - 6.4 [Skeletons match the dimensions of the content they replace](references\u002Fstream-skeleton-matching.md) — MEDIUM\n   - 6.5 [Nest Suspense when content has a natural reveal order](references\u002Fstream-nested-suspense.md) — LOW-MEDIUM\n7. [Metadata & SEO](references\u002F_sections.md#7-metadata--seo) — **MEDIUM**\n   - 7.1 [Dynamic routes export `generateMetadata` for per-resource SEO](references\u002Fmeta-generate-metadata.md) — MEDIUM\n   - 7.2 [Generate sitemaps from actual data — never hand-maintain XML](references\u002Fmeta-sitemap.md) — MEDIUM\n   - 7.3 [Make crawl rules explicit via `app\u002Frobots.ts` and per-page metadata](references\u002Fmeta-robots.md) — MEDIUM\n   - 7.4 [Generate per-page OG images via `opengraph-image.tsx`](references\u002Fmeta-opengraph-images.md) — LOW-MEDIUM\n8. [Client Components](references\u002F_sections.md#8-client-components) — **LOW-MEDIUM**\n   - 8.1 [Push `'use client'` down to the interactive leaf](references\u002Fclient-use-client-boundary.md) — LOW-MEDIUM\n   - 8.2 [Server content reaches inside a Client Component via `children`](references\u002Fclient-children-pattern.md) — LOW-MEDIUM\n   - 8.3 [SSR and client initial render must produce identical HTML](references\u002Fclient-hydration-mismatch.md) — LOW-MEDIUM\n   - 8.4 [Wrap third-party scripts in `next\u002Fscript` with the right `strategy`](references\u002Fclient-third-party-scripts.md) — LOW-MEDIUM\n9. [Codebase Hygiene](references\u002F_sections.md#9-codebase-hygiene) — **CROSS-CUTTING** (multi-file findings; required for whole-repo audits)\n   - 9.1 [Extract duplicated server-side fetchers\u002Factions into a shared module](references\u002Fcross-extract-shared-logic.md) — HIGH\n   - 9.2 [Consolidate near-duplicate routes\u002Flayouts\u002Fcomponents](references\u002Fcross-component-consolidation.md) — HIGH\n   - 9.3 [Delete unreachable routes, unused Server Actions, orphan utilities](references\u002Fcross-dead-code.md) — MEDIUM-HIGH\n   - 9.4 [Audit `'use client'` placement across the route tree](references\u002Fcross-boundary-coherence.md) — HIGH\n   - 9.5 [Converge on canonical names for the same concept across routes\u002Fcomponents](references\u002Fcross-prop-shape-drift.md) — MEDIUM-HIGH\n\n## References\n\n1. [Next.js Documentation](https:\u002F\u002Fnextjs.org\u002Fdocs)\n2. [Next.js 16 Release Notes](https:\u002F\u002Fnextjs.org\u002Fblog\u002Fnext-16)\n3. [React Documentation](https:\u002F\u002Freact.dev)\n4. [Vercel Engineering Blog](https:\u002F\u002Fvercel.com\u002Fblog)\n\n## Related Skills\n\n- For React 19 fundamentals (concurrent rendering, hooks, components), see `react` skill\n- For client-side form handling, see `react-hook-form` skill\n- For client data caching with TanStack Query, see `tanstack-query` skill\n\n## Full Compiled Document\n\nFor the complete guide with all rules expanded: `AGENTS.md`\n",{"name":5,"description":7},"main","1ef0dcd00fe806a8dc4e0b7173b9db967c3ab274","skills\u002F.curated\u002Fnextjs","https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit","https:\u002F\u002Fgithub.com\u002Fngxccc","https:\u002F\u002Fngxccc.github.io","Make it work, make it right, make it fast.","2026-08-02 20:59:07",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add ngxccc\u002Fagent-skills-kit --skill nextjs",{"tool":38,"command":39},"bunx","bunx skills add ngxccc\u002Fagent-skills-kit --skill nextjs",{"tool":41,"command":42},"pnpm","pnpm dlx skills add ngxccc\u002Fagent-skills-kit --skill nextjs","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002FSKILL.md",true,[46,52,58,62,66,70,74,78,82,86,90,94,98,102,106,110,114,118,122,126,130,134,138,142,146,150,154,158,162,166,170,174,178,182,186,190,194,198,202,206,210,214,218,222,226,230,234,238,242],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"AGENTS.md","REFERENCE","参考文档",8017,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002FAGENTS.md",{"path":53,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":56,"sourceHtmlUrl":57},"assets\u002Ftemplates\u002F_template.md","ASSET","资产文件",559,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Fassets\u002Ftemplates\u002F_template.md",{"path":59,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":60,"sourceHtmlUrl":61},"references\u002F_review-algorithm.md",16399,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002F_review-algorithm.md",{"path":63,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":64,"sourceHtmlUrl":65},"references\u002F_sections.md",2794,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002F_sections.md",{"path":67,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":68,"sourceHtmlUrl":69},"references\u002Faction-error-handling.md",3191,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Faction-error-handling.md",{"path":71,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":72,"sourceHtmlUrl":73},"references\u002Faction-optimistic-updates.md",3328,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Faction-optimistic-updates.md",{"path":75,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":76,"sourceHtmlUrl":77},"references\u002Faction-pending-states.md",2953,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Faction-pending-states.md",{"path":79,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":80,"sourceHtmlUrl":81},"references\u002Faction-revalidation.md",3043,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Faction-revalidation.md",{"path":83,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":84,"sourceHtmlUrl":85},"references\u002Faction-server-action-forms.md",6615,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Faction-server-action-forms.md",{"path":87,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":88,"sourceHtmlUrl":89},"references\u002Fbuild-barrel-files.md",2645,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fbuild-barrel-files.md",{"path":91,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":92,"sourceHtmlUrl":93},"references\u002Fbuild-dynamic-imports.md",4774,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fbuild-dynamic-imports.md",{"path":95,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":96,"sourceHtmlUrl":97},"references\u002Fbuild-external-packages.md",2494,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fbuild-external-packages.md",{"path":99,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":100,"sourceHtmlUrl":101},"references\u002Fbuild-optimize-package-imports.md",2663,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fbuild-optimize-package-imports.md",{"path":103,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":104,"sourceHtmlUrl":105},"references\u002Fbuild-turbopack-config.md",2764,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fbuild-turbopack-config.md",{"path":107,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":108,"sourceHtmlUrl":109},"references\u002Fcache-fetch-options.md",3313,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fcache-fetch-options.md",{"path":111,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":112,"sourceHtmlUrl":113},"references\u002Fcache-react-cache.md",3115,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fcache-react-cache.md",{"path":115,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":116,"sourceHtmlUrl":117},"references\u002Fcache-revalidate-path.md",3187,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fcache-revalidate-path.md",{"path":119,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":120,"sourceHtmlUrl":121},"references\u002Fcache-revalidate-tag.md",3017,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fcache-revalidate-tag.md",{"path":123,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":124,"sourceHtmlUrl":125},"references\u002Fcache-segment-config.md",3274,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fcache-segment-config.md",{"path":127,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":128,"sourceHtmlUrl":129},"references\u002Fcache-use-cache-directive.md",4978,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fcache-use-cache-directive.md",{"path":131,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":132,"sourceHtmlUrl":133},"references\u002Fclient-children-pattern.md",3366,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fclient-children-pattern.md",{"path":135,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":136,"sourceHtmlUrl":137},"references\u002Fclient-hydration-mismatch.md",3151,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fclient-hydration-mismatch.md",{"path":139,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":140,"sourceHtmlUrl":141},"references\u002Fclient-third-party-scripts.md",3436,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fclient-third-party-scripts.md",{"path":143,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":144,"sourceHtmlUrl":145},"references\u002Fclient-use-client-boundary.md",6303,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fclient-use-client-boundary.md",{"path":147,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":148,"sourceHtmlUrl":149},"references\u002Fcross-boundary-coherence.md",6144,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fcross-boundary-coherence.md",{"path":151,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":152,"sourceHtmlUrl":153},"references\u002Fcross-component-consolidation.md",5361,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fcross-component-consolidation.md",{"path":155,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":156,"sourceHtmlUrl":157},"references\u002Fcross-dead-code.md",5859,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fcross-dead-code.md",{"path":159,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":160,"sourceHtmlUrl":161},"references\u002Fcross-extract-shared-logic.md",4977,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fcross-extract-shared-logic.md",{"path":163,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":164,"sourceHtmlUrl":165},"references\u002Fcross-prop-shape-drift.md",6021,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fcross-prop-shape-drift.md",{"path":167,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":168,"sourceHtmlUrl":169},"references\u002Fmeta-generate-metadata.md",2991,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fmeta-generate-metadata.md",{"path":171,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":172,"sourceHtmlUrl":173},"references\u002Fmeta-opengraph-images.md",3226,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fmeta-opengraph-images.md",{"path":175,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":176,"sourceHtmlUrl":177},"references\u002Fmeta-robots.md",2741,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fmeta-robots.md",{"path":179,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":180,"sourceHtmlUrl":181},"references\u002Fmeta-sitemap.md",3077,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fmeta-sitemap.md",{"path":183,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":184,"sourceHtmlUrl":185},"references\u002Froute-intercepting-routes.md",3465,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Froute-intercepting-routes.md",{"path":187,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":188,"sourceHtmlUrl":189},"references\u002Froute-not-found.md",2887,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Froute-not-found.md",{"path":191,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":192,"sourceHtmlUrl":193},"references\u002Froute-parallel-routes.md",3351,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Froute-parallel-routes.md",{"path":195,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":196,"sourceHtmlUrl":197},"references\u002Froute-prefetching.md",3147,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Froute-prefetching.md",{"path":199,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":200,"sourceHtmlUrl":201},"references\u002Froute-proxy-ts.md",3046,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Froute-proxy-ts.md",{"path":203,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":204,"sourceHtmlUrl":205},"references\u002Fserver-avoid-client-fetching.md",5965,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fserver-avoid-client-fetching.md",{"path":207,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":208,"sourceHtmlUrl":209},"references\u002Fserver-component-streaming.md",3074,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fserver-component-streaming.md",{"path":211,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":212,"sourceHtmlUrl":213},"references\u002Fserver-data-colocation.md",3103,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fserver-data-colocation.md",{"path":215,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":216,"sourceHtmlUrl":217},"references\u002Fserver-error-handling.md",2955,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fserver-error-handling.md",{"path":219,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":220,"sourceHtmlUrl":221},"references\u002Fserver-parallel-fetching.md",5512,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fserver-parallel-fetching.md",{"path":223,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":224,"sourceHtmlUrl":225},"references\u002Fserver-preload-pattern.md",3273,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fserver-preload-pattern.md",{"path":227,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":228,"sourceHtmlUrl":229},"references\u002Fstream-error-tsx.md",3054,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fstream-error-tsx.md",{"path":231,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":232,"sourceHtmlUrl":233},"references\u002Fstream-loading-tsx.md",2901,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fstream-loading-tsx.md",{"path":235,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":236,"sourceHtmlUrl":237},"references\u002Fstream-nested-suspense.md",3512,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fstream-nested-suspense.md",{"path":239,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":240,"sourceHtmlUrl":241},"references\u002Fstream-skeleton-matching.md",3270,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fstream-skeleton-matching.md",{"path":243,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":244,"sourceHtmlUrl":245},"references\u002Fstream-suspense-boundaries.md",2898,"https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fnextjs\u002Freferences\u002Fstream-suspense-boundaries.md",[247,254,261,268,275,282],{"skillNo":248,"name":249,"nameZh":6,"description":250,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":251,"categories":252,"keywords":253,"publishedAt":19},"01M76W3C8X6Q5DS0364KQT7W7A","zustand","Rules and standards for state management using Zustand in React and Next.js. Use when implementing client-side stores, persistence with localStorage, or preventing SSR hydration mismatch.","https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fzustand\u002FSKILL.md",[],[],{"skillNo":255,"name":256,"nameZh":6,"description":257,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":258,"categories":259,"keywords":260,"publishedAt":19},"01M76W39FJGES309VAH7SFWA9Y","zod","Zod v4 schema validation best practices. Use when defining schemas, utilizing safeParse, or customizing error messages.","https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fzod\u002FSKILL.md",[],[],{"skillNo":262,"name":263,"nameZh":6,"description":264,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":265,"categories":266,"keywords":267,"publishedAt":19},"01M76W36HTYA4BR5FKCWMX1RFR","upstash-ratelimit","Rules, standards, and references for rate limiting in serverless environments using Upstash Ratelimit. Use when implementing rate limiting, configuring Upstash Redis, or handling request blocking.","https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fupstash-ratelimit\u002FSKILL.md",[],[],{"skillNo":269,"name":270,"nameZh":6,"description":271,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":272,"categories":273,"keywords":274,"publishedAt":19},"01M76W32H4PS01WFRS7FNPK2G1","ui-design","UI\u002FUX and frontend design best practices guidelines (formerly frontend-design). This skill should be used when writing, reviewing, or designing frontend code to ensure accessibility, performance, and usability. Triggers on tasks involving HTML structure, CSS styling, responsive layouts, form design, animations, or accessibility improvements.","https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Fui-design\u002FSKILL.md",[],[],{"skillNo":276,"name":277,"nameZh":6,"description":278,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":279,"categories":280,"keywords":281,"publishedAt":19},"01M76W2YAP6RK8N0EVWFG54VD7","typescript","TypeScript performance, tsconfig, type errors, async patterns — triggered when the user asks to \"optimize TypeScript performance\", \"speed up tsc compilation\", \"configure tsconfig.json\", \"fix type errors\", \"improve async patterns\", or encounters TS errors (TS2322, TS2339, \"is not assignable to\"). Also triggers on .ts, .tsx, .d.ts file work involving type definitions, module organization, or memory management. Does NOT cover TypeScript basics, framework-specific patterns, or testing.","https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Ftypescript\u002FSKILL.md",[],[],{"skillNo":283,"name":284,"nameZh":6,"description":285,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":286,"categories":287,"keywords":288,"publishedAt":19},"01M76W2RMAZNNJQ2HECH3X6ZSH","typescript-refactor","TypeScript and TSX refactoring and modernization guidelines from a principal specialist perspective, current to TypeScript 6.0 and React 19. This skill should be used when refactoring, reviewing, or modernizing TypeScript or React\u002FTSX code for type safety, compiler performance, and idiomatic patterns. Triggers on tasks involving type architecture, narrowing, generics, discriminated unions, error handling, React component and hook typing, or migration to modern TypeScript features (satisfies, using, const type parameters, inferred type predicates, isolatedDeclarations, erasable syntax, import attributes).","https:\u002F\u002Fgithub.com\u002Fngxccc\u002Fagent-skills-kit\u002Fblob\u002Fmain\u002Fskills\u002F.curated\u002Ftypescript-refactor\u002FSKILL.md",[],[]]