[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M71ED1ZJK5ZP3CJ8WDWMA48Y":3,"skill-same:01M71ED1ZJK5ZP3CJ8WDWMA48Y":393},{"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":34,"publishedAt":54,"linkOnly":55,"markdownContent":56,"markdownBody":57,"frontMatter":58,"refName":285,"commitSha":286,"skillDirectory":287,"forksCount":14,"repositoryHtmlUrl":288,"repositoryHomepageUrl":6,"ownerHtmlUrl":289,"ownerBlogUrl":290,"ownerDescription":291,"updatedAt":292,"install":293,"resources":306},"01M71ED1ZJK5ZP3CJ8WDWMA48Y","nextjs",null,"Next.js App Router expert guidance. Use when building, debugging, or architecting Next.js applications — routing, Server Components, Server Actions, Cache Components, layouts, middleware\u002Fproxy, data fetching, rendering strategies, and deployment on Vercel.","patinaproject\u002Fskills","patinaproject","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F229996889?v=4","01M71E58JKTDNY1138WYZK44TR","Patina Project","01M71E58K5GH4K16MV6A8BQ6NZ",1,"MIT","https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnextjs\u002FSKILL.md",[18,23,26,31],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000009","前端开发","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000010","后端与接口",{"categoryNo":27,"categoryName":28,"taxonomyType":29,"taxonomyTypeDesc":30},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",{"categoryNo":32,"categoryName":33,"taxonomyType":29,"taxonomyTypeDesc":30},"01JBSEEDCAT000000000000033","数据分析师",[5,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53],"migrate","component","delete","server","create","router","react","prisma","express","components","@neondatabase\u002Fserverless","auth0","static","project","react 19","tsx","cold","app","shared","2026-11-10 10:12:30",false,"---\nname: nextjs\ndescription: Next.js App Router expert guidance. Use when building, debugging, or architecting Next.js applications — routing, Server Components, Server Actions, Cache Components, layouts, middleware\u002Fproxy, data fetching, rendering strategies, and deployment on Vercel.\nmetadata:\n  priority: 5\n  docs:\n    - \"https:\u002F\u002Fnextjs.org\u002Fdocs\"\n    - \"https:\u002F\u002Fnextjs.org\u002Fdocs\u002Fapp\"\n  sitemap: \"https:\u002F\u002Fnextjs.org\u002Fsitemap.xml\"\n  pathPatterns:\n    - 'next.config.*'\n    - 'next-env.d.ts'\n    - 'app\u002F**'\n    - 'pages\u002F**'\n    - 'src\u002Fapp\u002F**'\n    - 'src\u002Fpages\u002F**'\n    - 'tailwind.config.*'\n    - 'postcss.config.*'\n    - 'tsconfig.json'\n    - 'tsconfig.*.json'\n    - 'apps\u002F*\u002Fapp\u002F**'\n    - 'apps\u002F*\u002Fpages\u002F**'\n    - 'apps\u002F*\u002Fsrc\u002Fapp\u002F**'\n    - 'apps\u002F*\u002Fsrc\u002Fpages\u002F**'\n    - 'apps\u002F*\u002Fnext.config.*'\n  bashPatterns:\n    - '\\bnext\\s+(dev|build|start|lint)\\b'\n    - '\\bnext\\s+experimental-analyze\\b'\n    - '\\bnpx\\s+create-next-app\\b'\n    - '\\bbunx\\s+create-next-app\\b'\n    - '\\bnpm\\s+run\\s+(dev|build|start)\\b'\n    - '\\bpnpm\\s+(dev|build)\\b'\n    - '\\bbun\\s+run\\s+(dev|build)\\b'\n  promptSignals:\n    phrases:\n      - \"next.js\"\n      - \"nextjs\"\n      - \"app router\"\n      - \"server component\"\n      - \"server action\"\n    allOf:\n      - [middleware, next]\n      - [layout, route]\n    anyOf:\n      - \"pages router\"\n      - \"getserversideprops\"\n      - \"use server\"\n    noneOf: []\n    minScore: 6\nvalidate:\n  -\n    pattern: export.*getServerSideProps\n    message: 'getServerSideProps is removed in App Router — use server components or route handlers'\n    severity: error\n    upgradeToSkill: nextjs\n    upgradeWhy: 'Guides migration from Pages Router getServerSideProps to App Router server components with async data fetching.'\n  -\n    pattern: getServerSideProps\n    message: 'getServerSideProps is a Pages Router pattern — migrate to App Router server components'\n    severity: warn\n  -\n    pattern: export.*getStaticProps\n    message: 'getStaticProps is removed in App Router — use generateStaticParams + server components instead'\n    severity: error\n    upgradeToSkill: nextjs\n    upgradeWhy: 'Guides migration from Pages Router getStaticProps to App Router generateStaticParams with server components.'\n  -\n    pattern: getStaticProps\n    message: 'getStaticProps is a Pages Router pattern — migrate to App Router generateStaticParams + server components'\n    severity: warn\n  -\n    pattern: from\\s+['\"]next\u002Frouter['\"]\n    message: 'next\u002Frouter is Pages Router only — use next\u002Fnavigation for App Router'\n    severity: error\n    upgradeToSkill: nextjs\n    upgradeWhy: 'Guides migration from next\u002Frouter to next\u002Fnavigation with useRouter, usePathname, useSearchParams hooks.'\n  -\n    pattern: (useState|useEffect)\n    message: 'React hooks require \"use client\" directive — add it at the top of client components'\n    severity: warn\n    skipIfFileContains: \"^['\\\"]use client['\\\"]\"\n  -\n    pattern: from\\s+['\"]next\u002Fhead['\"]\n    message: 'next\u002Fhead is Pages Router — use export const metadata or generateMetadata() in App Router. Run Skill(nextjs) for metadata API guidance.'\n    severity: error\n    upgradeToSkill: nextjs\n    upgradeWhy: 'Guides migration from next\u002Fhead to the App Router metadata API (export const metadata \u002F generateMetadata()).'\n    skipIfFileContains: export\\s+(const\\s+)?metadata|generateMetadata\n  -\n    pattern: export\\s+(default\\s+)?function\\s+middleware\n    message: 'middleware() is renamed to proxy() in Next.js 16 — rename the function and the file to proxy.ts. Run Skill(routing-middleware) for proxy.ts migration guidance.'\n    severity: recommended\n    upgradeToSkill: routing-middleware\n    upgradeWhy: 'Guides migration from middleware.ts to proxy.ts with correct file placement, runtime config, and request interception patterns.'\n  -\n    pattern: revalidateTag\\(\\s*['\"][^'\"]+['\"]\\s*\\)\n    message: 'Single-arg revalidateTag(tag) is deprecated in Next.js 16 — pass a cacheLife profile: revalidateTag(tag, \"max\")'\n    severity: recommended\n    upgradeToSkill: nextjs\n    upgradeWhy: 'Guides migration from single-arg revalidateTag to the Next.js 16 two-arg API with cacheLife profiles.'\n  -\n    pattern: '\\bcacheHandler\\s*:'\n    message: 'Singular cacheHandler is deprecated in Next.js 16 — use cacheHandlers (plural) with per-type handlers'\n    severity: recommended\n    upgradeToSkill: nextjs\n    upgradeWhy: 'Guides migration from singular cacheHandler to Next.js 16 cacheHandlers (plural) with per-type handler config.'\n  -\n    pattern: useRef\\(\\s*\\)\n    message: 'useRef() requires an initial value in React 19 — use useRef(null) or useRef(0)'\n    severity: error\n  -\n    pattern: next\\s+export\n    message: 'next export was removed — use output: \"export\" in next.config.js for static export'\n    severity: error\n    upgradeToSkill: nextjs\n    upgradeWhy: 'Guides migration from next export CLI command to output: \"export\" in next.config for static site generation.'\n  -\n    pattern: (?\u003C!await )\\bcookies\\(\\s*\\)\n    message: 'cookies() is async in Next.js 16 — add await: const cookieStore = await cookies()'\n    severity: error\n    skipIfFileContains: \"^['\\\"]use client['\\\"]\"\n  -\n    pattern: (?\u003C!await )\\bheaders\\(\\s*\\)\n    message: 'headers() is async in Next.js 16 — add await: const headersList = await headers()'\n    severity: error\n    skipIfFileContains: \"^['\\\"]use client['\\\"]\"\n  -\n    pattern: =\\s*(?!await\\b)params\\b\n    message: 'params is async in Next.js 16 — add await: const { slug } = await params'\n    severity: recommended\n    skipIfFileContains: \"^['\\\"]use client['\\\"]\"\n  -\n    pattern: =\\s*(?!await\\b)searchParams\\b\n    message: 'searchParams is async in Next.js 16 — add await: const { query } = await searchParams'\n    severity: recommended\n    skipIfFileContains: \"^['\\\"]use client['\\\"]\"\n  -\n    pattern: 'from\\s+[''\"\"](next-auth|@auth\u002Fcore)[''\"\"]|NextAuth\\(|getServerSession\\('\n    message: 'Legacy auth pattern detected. Modern Vercel apps should use Clerk, Descope, or Auth0 for managed authentication.'\n    severity: recommended\n    upgradeToSkill: auth\n    upgradeWhy: 'Migrate from next-auth\u002Fmanual JWT to a managed auth provider (Clerk, Descope, Auth0) for better Vercel integration.'\n    skipIfFileContains: '@clerk\u002F|@descope\u002F|@auth0\u002F'\n  -\n    pattern: 'NextApiRequest|NextApiResponse|export\\s+default\\s+function\\s+handler'\n    message: 'Pages Router API handler detected. Use App Router route handlers with named HTTP exports instead.'\n    severity: recommended\n    upgradeToSkill: vercel-functions\n    upgradeWhy: 'Migrate from Pages Router API routes to App Router route handlers with Web Request\u002FResponse API.'\n    skipIfFileContains: 'export\\s+(async\\s+)?function\\s+(GET|POST|PUT|PATCH|DELETE)'\n  -\n    pattern: 'from\\s+[''\"\"](lru-cache|node-cache|memory-cache)[''\"\"]|new\\s+(LRUCache|NodeCache)\\('\n    message: 'In-process cache detected. Serverless deployments lose process memory between invocations.'\n    severity: recommended\n    upgradeToSkill: runtime-cache\n    upgradeWhy: 'Replace process-memory caches with Vercel Runtime Cache for shared, region-aware caching.'\n  -\n    pattern: 'from\\s+[''\"\"](express|fastify|koa|hapi)[''\"\"]|require\\s*\\(\\s*[''\"\"](express|fastify|koa|hapi)[''\"\"]'\n    message: 'Express\u002FFastify\u002FKoa\u002FHapi server framework detected in a Next.js project. Use Next.js route handlers or proxy.ts for request handling instead.'\n    severity: recommended\n    upgradeToSkill: routing-middleware\n    upgradeWhy: 'Replace custom server frameworks with Next.js proxy.ts for request interception and route handlers for API endpoints.'\n    skipIfFileContains: 'proxy\\.ts|from\\s+[''\"\"](next\u002Fserver)[''\"\"]|@vercel\u002Ffunctions'\n  -\n    pattern: 'from\\s+[''\"\"](typeorm|sequelize|mikro-orm|objection|bookshelf|knex)[''\"\"]|require\\s*\\(\\s*[''\"\"](typeorm|sequelize|mikro-orm|objection|bookshelf|knex)[''\"\"]'\n    message: 'Heavy ORM detected. Consider using lightweight serverless-native alternatives like Drizzle, Prisma, or direct Neon for better cold start performance.'\n    severity: recommended\n    upgradeToSkill: vercel-storage\n    upgradeWhy: 'Migrate from heavy ORMs to serverless-native database clients (Drizzle + Neon, Prisma, or @neondatabase\u002Fserverless) for faster cold starts.'\n    skipIfFileContains: 'from\\s+[''\"\"](drizzle-orm|@neondatabase|@prisma\u002Fclient|prisma)[''\"\"]'\n  -\n    pattern: 'fonts\\.googleapis\\.com|from\\s+[''\"\"](fontsource|@fontsource)[''\"\"]|\u003Clink[^>]*fonts\\.googleapis'\n    message: 'External font loader detected. Use next\u002Ffont for zero-CLS, self-hosted font loading with automatic optimization.'\n    severity: recommended\n    upgradeToSkill: nextjs\n    upgradeWhy: 'Guides migration from external font loaders to next\u002Ffont with Geist Sans\u002FMono for zero-CLS font optimization.'\n    skipIfFileContains: 'next\u002Ffont'\nchainTo:\n  -\n    pattern: 'export\\s+(default\\s+)?function\\s+middleware'\n    targetSkill: routing-middleware\n    message: 'middleware() is renamed to proxy() in Next.js 16 — loading Routing Middleware guidance for proxy.ts migration.'\n  -\n    pattern: \"from\\\\s+['\\\"]@vercel\u002F(postgres|kv)['\\\"]\"\n    targetSkill: vercel-storage\n    message: 'Sunset storage package detected — loading Vercel Storage guidance for Neon\u002FUpstash migration.'\n  -\n    pattern: \"from\\\\s+['\\\"]@ai-sdk\u002F(anthropic|openai)['\\\"]\"\n    targetSkill: ai-gateway\n    message: 'Direct AI provider SDK import — loading AI Gateway guidance for unified model routing with failover and cost tracking.'\n  -\n    pattern: 'from\\s+[''\"\"](next-auth|@auth\u002Fcore)[''\"\"]|NextAuth\\(|getServerSession\\('\n    targetSkill: auth\n    message: 'Legacy auth pattern detected — loading managed authentication guidance (Clerk, Descope, Auth0).'\n  -\n    pattern: 'NextApiRequest|NextApiResponse|export\\s+default\\s+function\\s+handler'\n    targetSkill: vercel-functions\n    message: 'Pages Router API handler detected — loading Vercel Functions guidance for App Router migration.'\n  -\n    pattern: 'from\\s+[''\"\"](lru-cache|node-cache|memory-cache)[''\"\"]|new\\s+(LRUCache|NodeCache)\\('\n    targetSkill: runtime-cache\n    message: 'In-process cache detected — loading Runtime Cache guidance for serverless-compatible caching.'\n  -\n    pattern: 'fetch\\s*\\(\\s*[''\"\"](https?:\u002F\u002F)?(api\\.openai\\.com|api\\.anthropic\\.com|api\\.cohere\\.ai)'\n    targetSkill: ai-gateway\n    message: 'Raw AI provider fetch URL detected — loading AI Gateway guidance for unified routing, failover, and OIDC auth.'\n    skipIfFileContains: '@ai-sdk\u002F|from\\s+[''\"\"](ai)[''\"\"]|ai-gateway|gateway\\('\n  -\n    pattern: 'jwt\\.(sign|verify|decode)\\(|from\\s+[''\"\"](jsonwebtoken)[''\"\"]|new\\s+SignJWT\\(|jwtVerify\\('\n    targetSkill: auth\n    message: 'Manual JWT token handling detected — loading Auth guidance for managed authentication (Clerk, Descope, Auth0).'\n    skipIfFileContains: 'clerkMiddleware|@clerk\u002F|@auth0\u002F|@descope\u002F|from\\s+[''\"\"](next-auth)[''\"\"]'\n  -\n    pattern: 'from\\s+[''\"]@\u002Fcomponents\u002Fui\u002F|from\\s+[''\"]@\u002Fcomponents\u002Fui[''\"\"]'\n    targetSkill: shadcn\n    message: 'shadcn\u002Fui component imports detected — loading shadcn guidance for component composition, theming, and registry patterns.'\n    skipIfFileContains: 'shadcn|components\\.json'\n  -\n    pattern: 'from\\s+[''\"\"](styled-components|@emotion\u002F(react|styled)|@mui\u002Fmaterial)[''\"\"]'\n    targetSkill: shadcn\n    message: 'CSS-in-JS library detected — loading shadcn\u002Fui guidance for Tailwind CSS + Radix UI component patterns (Vercel recommended).'\n    skipIfFileContains: '@\u002Fcomponents\u002Fui|shadcn'\n  -\n    pattern: 'getInitialProps'\n    targetSkill: nextjs\n    message: 'getInitialProps is a legacy Pages Router pattern — loading Next.js guidance for App Router migration with server components and async data fetching.'\n    skipIfFileContains: 'app\u002F.*page\\.|generateStaticParams|use cache'\n  -\n    pattern: 'export.*getServerSideProps|getServerSideProps\\s*\\('\n    targetSkill: nextjs\n    message: 'getServerSideProps is a Pages Router pattern — loading Next.js guidance for App Router migration with server components and async data fetching.'\n    skipIfFileContains: 'generateStaticParams|use cache|app\u002F.*page\\.'\n  -\n    pattern: 'export.*getStaticProps|getStaticProps\\s*\\('\n    targetSkill: nextjs\n    message: 'getStaticProps is a Pages Router pattern — loading Next.js guidance for App Router migration with generateStaticParams and server components.'\n    skipIfFileContains: 'generateStaticParams|use cache|app\u002F.*page\\.'\n  -\n    pattern: '_app\\.(tsx?|jsx?)'\n    targetSkill: nextjs\n    message: '_app.tsx is a Pages Router pattern — loading Next.js guidance for App Router layout.tsx migration.'\n    skipIfFileContains: 'app\u002Flayout\\.|app\u002F.*layout\\.'\n  -\n    pattern: '_document\\.(tsx?|jsx?)'\n    targetSkill: nextjs\n    message: '_document.tsx is a Pages Router pattern — loading Next.js guidance for App Router layout.tsx with metadata API migration.'\n    skipIfFileContains: 'app\u002Flayout\\.|app\u002F.*layout\\.'\n  -\n    pattern: \"from\\\\s+['\\\"]next\u002Fdocument['\\\"]\"\n    targetSkill: nextjs\n    message: 'next\u002Fdocument is Pages Router only — loading Next.js guidance for App Router layout.tsx with html\u002Fbody structure.'\n    skipIfFileContains: 'app\u002Flayout\\.|app\u002F.*layout\\.'\n  -\n    pattern: 'pages\u002Fapi\u002F'\n    targetSkill: vercel-functions\n    message: 'Pages Router API route (pages\u002Fapi\u002F) detected — loading Vercel Functions guidance for App Router route handlers with named HTTP exports.'\n    skipIfFileContains: 'export\\s+(async\\s+)?function\\s+(GET|POST|PUT|PATCH|DELETE)'\nretrieval:\n  aliases:\n    - next.js\n    - nextjs app\n    - react framework\n    - app router\n  intents:\n    - set up routing and layouts in a Next.js app\n    - choose between server and client components for a feature\n    - configure data fetching or caching in App Router\n    - add middleware or proxy logic to handle requests\n    - set up server rendering for React pages\n    - add a new page with dynamic route segments\n  entities:\n    - App Router\n    - Server Components\n    - Server Actions\n    - generateMetadata\n    - layout\n    - proxy\n    - next.config\n  examples:\n    - add a new page with dynamic routing\n    - should this be a server or client component\n    - set up middleware for auth redirects\n    - configure caching for this data fetch\n    - set up server rendering for my pages\n\n---\n\n# Next.js Best Practices\n\nApply these rules when writing or reviewing Next.js code.\n\n## File Conventions\n\nSee [file-conventions.md](.\u002Ffile-conventions.md) for:\n- Project structure and special files\n- Route segments (dynamic, catch-all, groups)\n- Parallel and intercepting routes\n- Middleware rename in v16 (middleware → proxy)\n\n## RSC Boundaries\n\nDetect invalid React Server Component patterns.\n\nSee [rsc-boundaries.md](.\u002Frsc-boundaries.md) for:\n- Async client component detection (invalid)\n- Non-serializable props detection\n- Server Action exceptions\n\n## Async Patterns\n\nNext.js 15+ async API changes.\n\nSee [async-patterns.md](.\u002Fasync-patterns.md) for:\n- Async `params` and `searchParams`\n- Async `cookies()` and `headers()`\n- Migration codemod\n\n## Runtime Selection\n\nSee [runtime-selection.md](.\u002Fruntime-selection.md) for:\n- Default to Node.js runtime\n- When Edge runtime is appropriate\n\n## Directives\n\nSee [directives.md](.\u002Fdirectives.md) for:\n- `'use client'`, `'use server'` (React)\n- `'use cache'` (Next.js)\n\n## Functions\n\nSee [functions.md](.\u002Ffunctions.md) for:\n- Navigation hooks: `useRouter`, `usePathname`, `useSearchParams`, `useParams`\n- Server functions: `cookies`, `headers`, `draftMode`, `after`\n- Generate functions: `generateStaticParams`, `generateMetadata`\n\n## Error Handling\n\nSee [error-handling.md](.\u002Ferror-handling.md) for:\n- `error.tsx`, `global-error.tsx`, `not-found.tsx`\n- `redirect`, `permanentRedirect`, `notFound`\n- `forbidden`, `unauthorized` (auth errors)\n- `unstable_rethrow` for catch blocks\n\n## Data Patterns\n\nSee [data-patterns.md](.\u002Fdata-patterns.md) for:\n- Server Components vs Server Actions vs Route Handlers\n- Avoiding data waterfalls (`Promise.all`, Suspense, preload)\n- Client component data fetching\n\n## Route Handlers\n\nSee [route-handlers.md](.\u002Froute-handlers.md) for:\n- `route.ts` basics\n- GET handler conflicts with `page.tsx`\n- Environment behavior (no React DOM)\n- When to use vs Server Actions\n\n## Metadata & OG Images\n\nSee [metadata.md](.\u002Fmetadata.md) for:\n- Static and dynamic metadata\n- `generateMetadata` function\n- OG image generation with `next\u002Fog`\n- File-based metadata conventions\n\n## Image Optimization\n\nSee [image.md](.\u002Fimage.md) for:\n- Always use `next\u002Fimage` over `\u003Cimg>`\n- Remote images configuration\n- Responsive `sizes` attribute\n- Blur placeholders\n- Priority loading for LCP\n\n## Font Optimization\n\nSee [font.md](.\u002Ffont.md) for:\n- `next\u002Ffont` setup\n- Google Fonts, local fonts\n- Tailwind CSS integration\n- Preloading subsets\n\n## Bundling\n\nSee [bundling.md](.\u002Fbundling.md) for:\n- Server-incompatible packages\n- CSS imports (not link tags)\n- Polyfills (already included)\n- ESM\u002FCommonJS issues\n- Bundle analysis\n\n## Scripts\n\nSee [scripts.md](.\u002Fscripts.md) for:\n- `next\u002Fscript` vs native script tags\n- Inline scripts need `id`\n- Loading strategies\n- Google Analytics with `@next\u002Fthird-parties`\n\n## Hydration Errors\n\nSee [hydration-error.md](.\u002Fhydration-error.md) for:\n- Common causes (browser APIs, dates, invalid HTML)\n- Debugging with error overlay\n- Fixes for each cause\n\n## Suspense Boundaries\n\nSee [suspense-boundaries.md](.\u002Fsuspense-boundaries.md) for:\n- CSR bailout with `useSearchParams` and `usePathname`\n- Which hooks require Suspense boundaries\n\n## Parallel & Intercepting Routes\n\nSee [parallel-routes.md](.\u002Fparallel-routes.md) for:\n- Modal patterns with `@slot` and `(.)` interceptors\n- `default.tsx` for fallbacks\n- Closing modals correctly with `router.back()`\n\n## Self-Hosting\n\nSee [self-hosting.md](.\u002Fself-hosting.md) for:\n- `output: 'standalone'` for Docker\n- Cache handlers for multi-instance ISR\n- What works vs needs extra setup\n\n## Debug Tricks\n\nSee [debug-tricks.md](.\u002Fdebug-tricks.md) for:\n- MCP endpoint for AI-assisted debugging\n- Rebuild specific routes with `--debug-build-paths`\n\n","# Next.js Best Practices\n\nApply these rules when writing or reviewing Next.js code.\n\n## File Conventions\n\nSee [file-conventions.md](.\u002Ffile-conventions.md) for:\n- Project structure and special files\n- Route segments (dynamic, catch-all, groups)\n- Parallel and intercepting routes\n- Middleware rename in v16 (middleware → proxy)\n\n## RSC Boundaries\n\nDetect invalid React Server Component patterns.\n\nSee [rsc-boundaries.md](.\u002Frsc-boundaries.md) for:\n- Async client component detection (invalid)\n- Non-serializable props detection\n- Server Action exceptions\n\n## Async Patterns\n\nNext.js 15+ async API changes.\n\nSee [async-patterns.md](.\u002Fasync-patterns.md) for:\n- Async `params` and `searchParams`\n- Async `cookies()` and `headers()`\n- Migration codemod\n\n## Runtime Selection\n\nSee [runtime-selection.md](.\u002Fruntime-selection.md) for:\n- Default to Node.js runtime\n- When Edge runtime is appropriate\n\n## Directives\n\nSee [directives.md](.\u002Fdirectives.md) for:\n- `'use client'`, `'use server'` (React)\n- `'use cache'` (Next.js)\n\n## Functions\n\nSee [functions.md](.\u002Ffunctions.md) for:\n- Navigation hooks: `useRouter`, `usePathname`, `useSearchParams`, `useParams`\n- Server functions: `cookies`, `headers`, `draftMode`, `after`\n- Generate functions: `generateStaticParams`, `generateMetadata`\n\n## Error Handling\n\nSee [error-handling.md](.\u002Ferror-handling.md) for:\n- `error.tsx`, `global-error.tsx`, `not-found.tsx`\n- `redirect`, `permanentRedirect`, `notFound`\n- `forbidden`, `unauthorized` (auth errors)\n- `unstable_rethrow` for catch blocks\n\n## Data Patterns\n\nSee [data-patterns.md](.\u002Fdata-patterns.md) for:\n- Server Components vs Server Actions vs Route Handlers\n- Avoiding data waterfalls (`Promise.all`, Suspense, preload)\n- Client component data fetching\n\n## Route Handlers\n\nSee [route-handlers.md](.\u002Froute-handlers.md) for:\n- `route.ts` basics\n- GET handler conflicts with `page.tsx`\n- Environment behavior (no React DOM)\n- When to use vs Server Actions\n\n## Metadata & OG Images\n\nSee [metadata.md](.\u002Fmetadata.md) for:\n- Static and dynamic metadata\n- `generateMetadata` function\n- OG image generation with `next\u002Fog`\n- File-based metadata conventions\n\n## Image Optimization\n\nSee [image.md](.\u002Fimage.md) for:\n- Always use `next\u002Fimage` over `\u003Cimg>`\n- Remote images configuration\n- Responsive `sizes` attribute\n- Blur placeholders\n- Priority loading for LCP\n\n## Font Optimization\n\nSee [font.md](.\u002Ffont.md) for:\n- `next\u002Ffont` setup\n- Google Fonts, local fonts\n- Tailwind CSS integration\n- Preloading subsets\n\n## Bundling\n\nSee [bundling.md](.\u002Fbundling.md) for:\n- Server-incompatible packages\n- CSS imports (not link tags)\n- Polyfills (already included)\n- ESM\u002FCommonJS issues\n- Bundle analysis\n\n## Scripts\n\nSee [scripts.md](.\u002Fscripts.md) for:\n- `next\u002Fscript` vs native script tags\n- Inline scripts need `id`\n- Loading strategies\n- Google Analytics with `@next\u002Fthird-parties`\n\n## Hydration Errors\n\nSee [hydration-error.md](.\u002Fhydration-error.md) for:\n- Common causes (browser APIs, dates, invalid HTML)\n- Debugging with error overlay\n- Fixes for each cause\n\n## Suspense Boundaries\n\nSee [suspense-boundaries.md](.\u002Fsuspense-boundaries.md) for:\n- CSR bailout with `useSearchParams` and `usePathname`\n- Which hooks require Suspense boundaries\n\n## Parallel & Intercepting Routes\n\nSee [parallel-routes.md](.\u002Fparallel-routes.md) for:\n- Modal patterns with `@slot` and `(.)` interceptors\n- `default.tsx` for fallbacks\n- Closing modals correctly with `router.back()`\n\n## Self-Hosting\n\nSee [self-hosting.md](.\u002Fself-hosting.md) for:\n- `output: 'standalone'` for Docker\n- Cache handlers for multi-instance ISR\n- What works vs needs extra setup\n\n## Debug Tricks\n\nSee [debug-tricks.md](.\u002Fdebug-tricks.md) for:\n- MCP endpoint for AI-assisted debugging\n- Rebuild specific routes with `--debug-build-paths`\n\n",{"name":5,"chainTo":59,"metadata":126,"validate":175,"retrieval":261,"description":7},[60,64,68,72,76,80,84,88,92,97,101,105,109,112,116,119,122],{"message":61,"pattern":62,"targetSkill":63},"middleware() is renamed to proxy() in Next.js 16 — loading Routing Middleware guidance for proxy.ts migration.","export\\s+(default\\s+)?function\\s+middleware","routing-middleware",{"message":65,"pattern":66,"targetSkill":67},"Sunset storage package detected — loading Vercel Storage guidance for Neon\u002FUpstash migration.","from\\s+['\"]@vercel\u002F(postgres|kv)['\"]","vercel-storage",{"message":69,"pattern":70,"targetSkill":71},"Direct AI provider SDK import — loading AI Gateway guidance for unified model routing with failover and cost tracking.","from\\s+['\"]@ai-sdk\u002F(anthropic|openai)['\"]","ai-gateway",{"message":73,"pattern":74,"targetSkill":75},"Legacy auth pattern detected — loading managed authentication guidance (Clerk, Descope, Auth0).","from\\s+['\"\"](next-auth|@auth\u002Fcore)['\"\"]|NextAuth\\(|getServerSession\\(","auth",{"message":77,"pattern":78,"targetSkill":79},"Pages Router API handler detected — loading Vercel Functions guidance for App Router migration.","NextApiRequest|NextApiResponse|export\\s+default\\s+function\\s+handler","vercel-functions",{"message":81,"pattern":82,"targetSkill":83},"In-process cache detected — loading Runtime Cache guidance for serverless-compatible caching.","from\\s+['\"\"](lru-cache|node-cache|memory-cache)['\"\"]|new\\s+(LRUCache|NodeCache)\\(","runtime-cache",{"message":85,"pattern":86,"targetSkill":71,"skipIfFileContains":87},"Raw AI provider fetch URL detected — loading AI Gateway guidance for unified routing, failover, and OIDC auth.","fetch\\s*\\(\\s*['\"\"](https?:\u002F\u002F)?(api\\.openai\\.com|api\\.anthropic\\.com|api\\.cohere\\.ai)","@ai-sdk\u002F|from\\s+['\"\"](ai)['\"\"]|ai-gateway|gateway\\(",{"message":89,"pattern":90,"targetSkill":75,"skipIfFileContains":91},"Manual JWT token handling detected — loading Auth guidance for managed authentication (Clerk, Descope, Auth0).","jwt\\.(sign|verify|decode)\\(|from\\s+['\"\"](jsonwebtoken)['\"\"]|new\\s+SignJWT\\(|jwtVerify\\(","clerkMiddleware|@clerk\u002F|@auth0\u002F|@descope\u002F|from\\s+['\"\"](next-auth)['\"\"]",{"message":93,"pattern":94,"targetSkill":95,"skipIfFileContains":96},"shadcn\u002Fui component imports detected — loading shadcn guidance for component composition, theming, and registry patterns.","from\\s+['\"]@\u002Fcomponents\u002Fui\u002F|from\\s+['\"]@\u002Fcomponents\u002Fui['\"\"]","shadcn","shadcn|components\\.json",{"message":98,"pattern":99,"targetSkill":95,"skipIfFileContains":100},"CSS-in-JS library detected — loading shadcn\u002Fui guidance for Tailwind CSS + Radix UI component patterns (Vercel recommended).","from\\s+['\"\"](styled-components|@emotion\u002F(react|styled)|@mui\u002Fmaterial)['\"\"]","@\u002Fcomponents\u002Fui|shadcn",{"message":102,"pattern":103,"targetSkill":5,"skipIfFileContains":104},"getInitialProps is a legacy Pages Router pattern — loading Next.js guidance for App Router migration with server components and async data fetching.","getInitialProps","app\u002F.*page\\.|generateStaticParams|use cache",{"message":106,"pattern":107,"targetSkill":5,"skipIfFileContains":108},"getServerSideProps is a Pages Router pattern — loading Next.js guidance for App Router migration with server components and async data fetching.","export.*getServerSideProps|getServerSideProps\\s*\\(","generateStaticParams|use cache|app\u002F.*page\\.",{"message":110,"pattern":111,"targetSkill":5,"skipIfFileContains":108},"getStaticProps is a Pages Router pattern — loading Next.js guidance for App Router migration with generateStaticParams and server components.","export.*getStaticProps|getStaticProps\\s*\\(",{"message":113,"pattern":114,"targetSkill":5,"skipIfFileContains":115},"_app.tsx is a Pages Router pattern — loading Next.js guidance for App Router layout.tsx migration.","_app\\.(tsx?|jsx?)","app\u002Flayout\\.|app\u002F.*layout\\.",{"message":117,"pattern":118,"targetSkill":5,"skipIfFileContains":115},"_document.tsx is a Pages Router pattern — loading Next.js guidance for App Router layout.tsx with metadata API migration.","_document\\.(tsx?|jsx?)",{"message":120,"pattern":121,"targetSkill":5,"skipIfFileContains":115},"next\u002Fdocument is Pages Router only — loading Next.js guidance for App Router layout.tsx with html\u002Fbody structure.","from\\s+['\"]next\u002Fdocument['\"]",{"message":123,"pattern":124,"targetSkill":79,"skipIfFileContains":125},"Pages Router API route (pages\u002Fapi\u002F) detected — loading Vercel Functions guidance for App Router route handlers with named HTTP exports.","pages\u002Fapi\u002F","export\\s+(async\\s+)?function\\s+(GET|POST|PUT|PATCH|DELETE)",{"docs":127,"sitemap":130,"priority":131,"bashPatterns":132,"pathPatterns":140,"promptSignals":156},[128,129],"https:\u002F\u002Fnextjs.org\u002Fdocs","https:\u002F\u002Fnextjs.org\u002Fdocs\u002Fapp","https:\u002F\u002Fnextjs.org\u002Fsitemap.xml",5,[133,134,135,136,137,138,139],"\\bnext\\s+(dev|build|start|lint)\\b","\\bnext\\s+experimental-analyze\\b","\\bnpx\\s+create-next-app\\b","\\bbunx\\s+create-next-app\\b","\\bnpm\\s+run\\s+(dev|build|start)\\b","\\bpnpm\\s+(dev|build)\\b","\\bbun\\s+run\\s+(dev|build)\\b",[141,142,143,144,145,146,147,148,149,150,151,152,153,154,155],"next.config.*","next-env.d.ts","app\u002F**","pages\u002F**","src\u002Fapp\u002F**","src\u002Fpages\u002F**","tailwind.config.*","postcss.config.*","tsconfig.json","tsconfig.*.json","apps\u002F*\u002Fapp\u002F**","apps\u002F*\u002Fpages\u002F**","apps\u002F*\u002Fsrc\u002Fapp\u002F**","apps\u002F*\u002Fsrc\u002Fpages\u002F**","apps\u002F*\u002Fnext.config.*",{"allOf":157,"anyOf":164,"noneOf":168,"phrases":169,"minScore":174},[158,161],[159,160],"middleware","next",[162,163],"layout","route",[165,166,167],"pages router","getserversideprops","use server",[],[170,5,171,172,173],"next.js","app router","server component","server action",6,[176,181,185,189,192,196,200,205,209,213,217,220,224,227,230,233,236,240,243,246,251,256],{"message":177,"pattern":178,"severity":179,"upgradeWhy":180,"upgradeToSkill":5},"getServerSideProps is removed in App Router — use server components or route handlers","export.*getServerSideProps","error","Guides migration from Pages Router getServerSideProps to App Router server components with async data fetching.",{"message":182,"pattern":183,"severity":184},"getServerSideProps is a Pages Router pattern — migrate to App Router server components","getServerSideProps","warn",{"message":186,"pattern":187,"severity":179,"upgradeWhy":188,"upgradeToSkill":5},"getStaticProps is removed in App Router — use generateStaticParams + server components instead","export.*getStaticProps","Guides migration from Pages Router getStaticProps to App Router generateStaticParams with server components.",{"message":190,"pattern":191,"severity":184},"getStaticProps is a Pages Router pattern — migrate to App Router generateStaticParams + server components","getStaticProps",{"message":193,"pattern":194,"severity":179,"upgradeWhy":195,"upgradeToSkill":5},"next\u002Frouter is Pages Router only — use next\u002Fnavigation for App Router","from\\s+['\"]next\u002Frouter['\"]","Guides migration from next\u002Frouter to next\u002Fnavigation with useRouter, usePathname, useSearchParams hooks.",{"message":197,"pattern":198,"severity":184,"skipIfFileContains":199},"React hooks require \"use client\" directive — add it at the top of client components","(useState|useEffect)","^['\"]use client['\"]",{"message":201,"pattern":202,"severity":179,"upgradeWhy":203,"upgradeToSkill":5,"skipIfFileContains":204},"next\u002Fhead is Pages Router — use export const metadata or generateMetadata() in App Router. Run Skill(nextjs) for metadata API guidance.","from\\s+['\"]next\u002Fhead['\"]","Guides migration from next\u002Fhead to the App Router metadata API (export const metadata \u002F generateMetadata()).","export\\s+(const\\s+)?metadata|generateMetadata",{"message":206,"pattern":62,"severity":207,"upgradeWhy":208,"upgradeToSkill":63},"middleware() is renamed to proxy() in Next.js 16 — rename the function and the file to proxy.ts. Run Skill(routing-middleware) for proxy.ts migration guidance.","recommended","Guides migration from middleware.ts to proxy.ts with correct file placement, runtime config, and request interception patterns.",{"message":210,"pattern":211,"severity":207,"upgradeWhy":212,"upgradeToSkill":5},"Single-arg revalidateTag(tag) is deprecated in Next.js 16 — pass a cacheLife profile: revalidateTag(tag, \"max\")","revalidateTag\\(\\s*['\"][^'\"]+['\"]\\s*\\)","Guides migration from single-arg revalidateTag to the Next.js 16 two-arg API with cacheLife profiles.",{"message":214,"pattern":215,"severity":207,"upgradeWhy":216,"upgradeToSkill":5},"Singular cacheHandler is deprecated in Next.js 16 — use cacheHandlers (plural) with per-type handlers","\\bcacheHandler\\s*:","Guides migration from singular cacheHandler to Next.js 16 cacheHandlers (plural) with per-type handler config.",{"message":218,"pattern":219,"severity":179},"useRef() requires an initial value in React 19 — use useRef(null) or useRef(0)","useRef\\(\\s*\\)",{"message":221,"pattern":222,"severity":179,"upgradeWhy":223,"upgradeToSkill":5},"next export was removed — use output: \"export\" in next.config.js for static export","next\\s+export","Guides migration from next export CLI command to output: \"export\" in next.config for static site generation.",{"message":225,"pattern":226,"severity":179,"skipIfFileContains":199},"cookies() is async in Next.js 16 — add await: const cookieStore = await cookies()","(?\u003C!await )\\bcookies\\(\\s*\\)",{"message":228,"pattern":229,"severity":179,"skipIfFileContains":199},"headers() is async in Next.js 16 — add await: const headersList = await headers()","(?\u003C!await )\\bheaders\\(\\s*\\)",{"message":231,"pattern":232,"severity":207,"skipIfFileContains":199},"params is async in Next.js 16 — add await: const { slug } = await params","=\\s*(?!await\\b)params\\b",{"message":234,"pattern":235,"severity":207,"skipIfFileContains":199},"searchParams is async in Next.js 16 — add await: const { query } = await searchParams","=\\s*(?!await\\b)searchParams\\b",{"message":237,"pattern":74,"severity":207,"upgradeWhy":238,"upgradeToSkill":75,"skipIfFileContains":239},"Legacy auth pattern detected. Modern Vercel apps should use Clerk, Descope, or Auth0 for managed authentication.","Migrate from next-auth\u002Fmanual JWT to a managed auth provider (Clerk, Descope, Auth0) for better Vercel integration.","@clerk\u002F|@descope\u002F|@auth0\u002F",{"message":241,"pattern":78,"severity":207,"upgradeWhy":242,"upgradeToSkill":79,"skipIfFileContains":125},"Pages Router API handler detected. Use App Router route handlers with named HTTP exports instead.","Migrate from Pages Router API routes to App Router route handlers with Web Request\u002FResponse API.",{"message":244,"pattern":82,"severity":207,"upgradeWhy":245,"upgradeToSkill":83},"In-process cache detected. Serverless deployments lose process memory between invocations.","Replace process-memory caches with Vercel Runtime Cache for shared, region-aware caching.",{"message":247,"pattern":248,"severity":207,"upgradeWhy":249,"upgradeToSkill":63,"skipIfFileContains":250},"Express\u002FFastify\u002FKoa\u002FHapi server framework detected in a Next.js project. Use Next.js route handlers or proxy.ts for request handling instead.","from\\s+['\"\"](express|fastify|koa|hapi)['\"\"]|require\\s*\\(\\s*['\"\"](express|fastify|koa|hapi)['\"\"]","Replace custom server frameworks with Next.js proxy.ts for request interception and route handlers for API endpoints.","proxy\\.ts|from\\s+['\"\"](next\u002Fserver)['\"\"]|@vercel\u002Ffunctions",{"message":252,"pattern":253,"severity":207,"upgradeWhy":254,"upgradeToSkill":67,"skipIfFileContains":255},"Heavy ORM detected. Consider using lightweight serverless-native alternatives like Drizzle, Prisma, or direct Neon for better cold start performance.","from\\s+['\"\"](typeorm|sequelize|mikro-orm|objection|bookshelf|knex)['\"\"]|require\\s*\\(\\s*['\"\"](typeorm|sequelize|mikro-orm|objection|bookshelf|knex)['\"\"]","Migrate from heavy ORMs to serverless-native database clients (Drizzle + Neon, Prisma, or @neondatabase\u002Fserverless) for faster cold starts.","from\\s+['\"\"](drizzle-orm|@neondatabase|@prisma\u002Fclient|prisma)['\"\"]",{"message":257,"pattern":258,"severity":207,"upgradeWhy":259,"upgradeToSkill":5,"skipIfFileContains":260},"External font loader detected. Use next\u002Ffont for zero-CLS, self-hosted font loading with automatic optimization.","fonts\\.googleapis\\.com|from\\s+['\"\"](fontsource|@fontsource)['\"\"]|\u003Clink[^>]*fonts\\.googleapis","Guides migration from external font loaders to next\u002Ffont with Geist Sans\u002FMono for zero-CLS font optimization.","next\u002Ffont",{"aliases":262,"intents":265,"entities":272,"examples":279},[170,263,264,171],"nextjs app","react framework",[266,267,268,269,270,271],"set up routing and layouts in a Next.js app","choose between server and client components for a feature","configure data fetching or caching in App Router","add middleware or proxy logic to handle requests","set up server rendering for React pages","add a new page with dynamic route segments",[273,274,275,276,162,277,278],"App Router","Server Components","Server Actions","generateMetadata","proxy","next.config",[280,281,282,283,284],"add a new page with dynamic routing","should this be a server or client component","set up middleware for auth redirects","configure caching for this data fetch","set up server rendering for my pages","main","e6ee720f466a8344a52abd87679191fadde3b63f",".agents\u002Fskills\u002Fnextjs","https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills","https:\u002F\u002Fgithub.com\u002Fpatinaproject","https:\u002F\u002Fwww.patinaproject.com","The best way to pick your next pair of boots or shoes.","2026-11-12 00:44:02",{"source":8,"skillName":5,"commands":294,"prompt":304,"zipAvailable":305},[295,298,301],{"tool":296,"command":297},"npx","npx skills add patinaproject\u002Fskills --skill nextjs",{"tool":299,"command":300},"bunx","bunx skills add patinaproject\u002Fskills --skill nextjs",{"tool":302,"command":303},"pnpm","pnpm dlx skills add patinaproject\u002Fskills --skill nextjs","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnextjs\u002FSKILL.md",true,[307,313,317,321,325,329,333,337,341,345,349,353,357,361,365,369,373,377,381,385,389],{"path":308,"resourceType":309,"resourceTypeDesc":310,"sizeBytes":311,"sourceHtmlUrl":312},"overlay.yaml","REFERENCE","参考文档",14202,"https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnextjs\u002Foverlay.yaml",{"path":314,"resourceType":309,"resourceTypeDesc":310,"sizeBytes":315,"sourceHtmlUrl":316},"references\u002Fapp-router-files.md",2610,"https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnextjs\u002Freferences\u002Fapp-router-files.md",{"path":318,"resourceType":309,"resourceTypeDesc":310,"sizeBytes":319,"sourceHtmlUrl":320},"references\u002Fasync-patterns.md",1664,"https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnextjs\u002Freferences\u002Fasync-patterns.md",{"path":322,"resourceType":309,"resourceTypeDesc":310,"sizeBytes":323,"sourceHtmlUrl":324},"references\u002Fbundling.md",4456,"https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnextjs\u002Freferences\u002Fbundling.md",{"path":326,"resourceType":309,"resourceTypeDesc":310,"sizeBytes":327,"sourceHtmlUrl":328},"references\u002Fdata-patterns.md",6687,"https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnextjs\u002Freferences\u002Fdata-patterns.md",{"path":330,"resourceType":309,"resourceTypeDesc":310,"sizeBytes":331,"sourceHtmlUrl":332},"references\u002Fdebug-tricks.md",2953,"https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnextjs\u002Freferences\u002Fdebug-tricks.md",{"path":334,"resourceType":309,"resourceTypeDesc":310,"sizeBytes":335,"sourceHtmlUrl":336},"references\u002Fdirectives.md",1476,"https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnextjs\u002Freferences\u002Fdirectives.md",{"path":338,"resourceType":309,"resourceTypeDesc":310,"sizeBytes":339,"sourceHtmlUrl":340},"references\u002Ferror-handling.md",4736,"https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnextjs\u002Freferences\u002Ferror-handling.md",{"path":342,"resourceType":309,"resourceTypeDesc":310,"sizeBytes":343,"sourceHtmlUrl":344},"references\u002Ffile-conventions.md",3464,"https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnextjs\u002Freferences\u002Ffile-conventions.md",{"path":346,"resourceType":309,"resourceTypeDesc":310,"sizeBytes":347,"sourceHtmlUrl":348},"references\u002Ffont.md",5196,"https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnextjs\u002Freferences\u002Ffont.md",{"path":350,"resourceType":309,"resourceTypeDesc":310,"sizeBytes":351,"sourceHtmlUrl":352},"references\u002Ffunctions.md",4388,"https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnextjs\u002Freferences\u002Ffunctions.md",{"path":354,"resourceType":309,"resourceTypeDesc":310,"sizeBytes":355,"sourceHtmlUrl":356},"references\u002Fhydration-error.md",1801,"https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnextjs\u002Freferences\u002Fhydration-error.md",{"path":358,"resourceType":309,"resourceTypeDesc":310,"sizeBytes":359,"sourceHtmlUrl":360},"references\u002Fimage.md",3882,"https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnextjs\u002Freferences\u002Fimage.md",{"path":362,"resourceType":309,"resourceTypeDesc":310,"sizeBytes":363,"sourceHtmlUrl":364},"references\u002Fmetadata.md",7140,"https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnextjs\u002Freferences\u002Fmetadata.md",{"path":366,"resourceType":309,"resourceTypeDesc":310,"sizeBytes":367,"sourceHtmlUrl":368},"references\u002Fparallel-routes.md",7171,"https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnextjs\u002Freferences\u002Fparallel-routes.md",{"path":370,"resourceType":309,"resourceTypeDesc":310,"sizeBytes":371,"sourceHtmlUrl":372},"references\u002Froute-handlers.md",3244,"https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnextjs\u002Freferences\u002Froute-handlers.md",{"path":374,"resourceType":309,"resourceTypeDesc":310,"sizeBytes":375,"sourceHtmlUrl":376},"references\u002Frsc-boundaries.md",4309,"https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnextjs\u002Freferences\u002Frsc-boundaries.md",{"path":378,"resourceType":309,"resourceTypeDesc":310,"sizeBytes":379,"sourceHtmlUrl":380},"references\u002Fruntime-selection.md",985,"https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnextjs\u002Freferences\u002Fruntime-selection.md",{"path":382,"resourceType":309,"resourceTypeDesc":310,"sizeBytes":383,"sourceHtmlUrl":384},"references\u002Fscripts.md",3326,"https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnextjs\u002Freferences\u002Fscripts.md",{"path":386,"resourceType":309,"resourceTypeDesc":310,"sizeBytes":387,"sourceHtmlUrl":388},"references\u002Fself-hosting.md",8334,"https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnextjs\u002Freferences\u002Fself-hosting.md",{"path":390,"resourceType":309,"resourceTypeDesc":310,"sizeBytes":391,"sourceHtmlUrl":392},"references\u002Fsuspense-boundaries.md",1366,"https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fnextjs\u002Freferences\u002Fsuspense-boundaries.md",[394,402,429,441,464,487],{"skillNo":395,"name":396,"nameZh":6,"description":397,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":398,"categories":399,"keywords":400,"publishedAt":401},"01M72KDQJR99954NE224VB3KZ2","code-review","Review the changes since a fixed point (commit, branch, tag, or merge-base) along five axes: Standards (does the code follow this repo's documented coding standards?), Spec (does the code match what the originating issue\u002Fspec asked for?), Evidence (does each claim in the pull request have evidence that shows it?), Bugs (does the changed code have logic errors, unhandled states, races, or regressions?), and Security (does the change open injection, auth, secret, input, or CI workflow holes?). Runs the reviews in parallel sub-agents, tags every finding Important, Nit, or Pre-existing, and reports them side by side with what blocks merge. Given an earlier reviewed head and its findings, it reviews only the newer commits, rechecks the earlier findings, and never repeats one. Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to \"review since X\".","https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002Fplugins\u002Fcode\u002Fskills\u002Fcode-review\u002FSKILL.md",[],[],"2026-11-10 22:39:42",{"skillNo":403,"name":404,"nameZh":6,"description":405,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":406,"categories":407,"keywords":414,"publishedAt":54},"01M71ESEDVHD9EXN6787XHP7HD","writing-for-pstack","Write or tighten an operator prompt for a patina-mode run. Use when the operator asks to write, revise, or review a prompt that will be passed to patina-mode.","https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002Fplugins\u002Fwork\u002Fskills\u002Fwriting-for-pstack\u002FSKILL.md",[408,411],{"categoryNo":409,"categoryName":410,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000018","写作与文案",{"categoryNo":412,"categoryName":413,"taxonomyType":29,"taxonomyTypeDesc":30},"01JBSEEDCAT000000000000036","内容创作者",[415,416,417,418,419,420,421,422,423,424,425,426,427,428],"for","pstack","writing","writing for pstack","review","run","mode","write","operator","use","tighten","prompt","when","revise",{"skillNo":430,"name":431,"nameZh":6,"description":432,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":433,"categories":434,"keywords":437,"publishedAt":54},"01M71ESCJ0SSJFFENF8HYDKBTJ","writing-for-agents","Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.","https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002Fplugins\u002Fwork\u002Fskills\u002Fwriting-for-agents\u002FSKILL.md",[435,436],{"categoryNo":409,"categoryName":410,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":412,"categoryName":413,"taxonomyType":29,"taxonomyTypeDesc":30},[438,415,417,439,424,440,427],"writing for agents","editing","documents",{"skillNo":442,"name":443,"nameZh":6,"description":444,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":445,"categories":446,"keywords":447,"publishedAt":54},"01M71ESA1NN9WVMD2HA5Z1RRDY","wizard","Generate an interactive bash wizard that walks a human through steps only they can perform. Use when provisioning infrastructure, setting up credentials or CI secrets, walking an unfamiliar third-party dashboard, or running a one-off migration or cutover. Don't invoke this for steps the agent can perform itself.","https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002Fplugins\u002Fwork\u002Fskills\u002Fwizard\u002FSKILL.md",[],[443,448,449,450,451,452,427,453,454,455,456,457,424,458,459,460,415,461,462,463],"interactive","can","credentials","one","Bash","invoke","dashboard","generate","human","secrets","provisioning infrastructure","ci","up","setting","running","only",{"skillNo":465,"name":466,"nameZh":6,"description":467,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":468,"categories":469,"keywords":470,"publishedAt":54},"01M71ES8FAN567N3JEPG8W6AS1","wayfinder","Plan a huge chunk of work (more than one agent session can hold) as a shared map of decision tickets on your issue tracker, and resolve them one at a time until the way to the destination is clear.","https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002Fplugins\u002Fwork\u002Fskills\u002Fwayfinder\u002FSKILL.md",[],[466,471,472,473,474,475,476,477,53,478,479,480,481,482,483,484,485,449,486,451],"more","true","decision","session","time","chunk","as","map","tickets","destination","at","tracker","plan","work","agent session","one at a time",{"skillNo":488,"name":489,"nameZh":6,"description":490,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":491,"categories":492,"keywords":493,"publishedAt":54},"01M71ES6PWJPKBW8R24YFH4PY6","wait-what","Stop. That last message did not land: re-pitch it.","https:\u002F\u002Fgithub.com\u002Fpatinaproject\u002Fskills\u002Fblob\u002Fmain\u002Fplugins\u002Fwork\u002Fskills\u002Fwait-what\u002FSKILL.md",[],[494,495,496,497,498,499,500,501,472,502],"wait","wait what","stop","it","land","re","pitch","message","last"]