[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6E1WE3RDP1D0D2GSBETHPY5":3,"skill-same:01M6E1WE3RDP1D0D2GSBETHPY5":398},{"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":288,"repositoryHtmlUrl":289,"repositoryHomepageUrl":290,"ownerHtmlUrl":291,"ownerBlogUrl":292,"ownerDescription":6,"updatedAt":293,"install":294,"resources":307},"01M6E1WE3RDP1D0D2GSBETHPY5","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.","ByeongminLee\u002Fnextjs-claude-code","ByeongminLee","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F71276006?v=4","01M6E1S467E7GC0NE144SWHC0V","Byeongmin Lee","01M6E1S4AV3W0B08Z2YBK26VG9",3,"MIT","https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002F.claude\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],"tsx","guides","apps","app","neon","prisma","express","project","shared","expert","css","analyze","migrate","Tailwind","Composition","actions","authentication","react","components","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","330a71e3d12264515ce3477e446d29fd34a88a9d","template\u002F.claude\u002Fskills\u002Fnextjs",1,"https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code","https:\u002F\u002Fbyeongminlee.github.io\u002Fnextjs-claude-code\u002F","https:\u002F\u002Fgithub.com\u002FByeongminLee","byeongmin.dev","2026-03-27 12:45:44",{"source":8,"skillName":5,"commands":295,"prompt":305,"zipAvailable":306},[296,299,302],{"tool":297,"command":298},"npx","npx skills add ByeongminLee\u002Fnextjs-claude-code --skill nextjs",{"tool":300,"command":301},"bunx","bunx skills add ByeongminLee\u002Fnextjs-claude-code --skill nextjs",{"tool":303,"command":304},"pnpm","pnpm dlx skills add ByeongminLee\u002Fnextjs-claude-code --skill nextjs","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002F.claude\u002Fskills\u002Fnextjs\u002FSKILL.md",true,[308,314,318,322,326,330,334,338,342,346,350,354,358,362,366,370,374,378,382,386,390,394],{"path":309,"resourceType":310,"resourceTypeDesc":311,"sizeBytes":312,"sourceHtmlUrl":313},"overlay.yaml","REFERENCE","参考文档",14202,"https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002F.claude\u002Fskills\u002Fnextjs\u002Foverlay.yaml",{"path":315,"resourceType":310,"resourceTypeDesc":311,"sizeBytes":316,"sourceHtmlUrl":317},"patterns.md",5848,"https:\u002F\u002Fgithub.com\u002Fmarshadgani\u002FArshad.AI\u002Fblob\u002Fclaude\u002Fai-personal-assistant-main\u002F.claude\u002Fskills\u002Fclaude-skills\u002Fgenerate\u002Fpatterns.md",{"path":319,"resourceType":310,"resourceTypeDesc":311,"sizeBytes":320,"sourceHtmlUrl":321},"references\u002Fapp-router-files.md",2610,"https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002F.claude\u002Fskills\u002Fnextjs\u002Freferences\u002Fapp-router-files.md",{"path":323,"resourceType":310,"resourceTypeDesc":311,"sizeBytes":324,"sourceHtmlUrl":325},"references\u002Fasync-patterns.md",1664,"https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002F.claude\u002Fskills\u002Fnextjs\u002Freferences\u002Fasync-patterns.md",{"path":327,"resourceType":310,"resourceTypeDesc":311,"sizeBytes":328,"sourceHtmlUrl":329},"references\u002Fbundling.md",4456,"https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002F.claude\u002Fskills\u002Fnextjs\u002Freferences\u002Fbundling.md",{"path":331,"resourceType":310,"resourceTypeDesc":311,"sizeBytes":332,"sourceHtmlUrl":333},"references\u002Fdata-patterns.md",6687,"https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002F.claude\u002Fskills\u002Fnextjs\u002Freferences\u002Fdata-patterns.md",{"path":335,"resourceType":310,"resourceTypeDesc":311,"sizeBytes":336,"sourceHtmlUrl":337},"references\u002Fdebug-tricks.md",2953,"https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002F.claude\u002Fskills\u002Fnextjs\u002Freferences\u002Fdebug-tricks.md",{"path":339,"resourceType":310,"resourceTypeDesc":311,"sizeBytes":340,"sourceHtmlUrl":341},"references\u002Fdirectives.md",1476,"https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002F.claude\u002Fskills\u002Fnextjs\u002Freferences\u002Fdirectives.md",{"path":343,"resourceType":310,"resourceTypeDesc":311,"sizeBytes":344,"sourceHtmlUrl":345},"references\u002Ferror-handling.md",4736,"https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002F.claude\u002Fskills\u002Fnextjs\u002Freferences\u002Ferror-handling.md",{"path":347,"resourceType":310,"resourceTypeDesc":311,"sizeBytes":348,"sourceHtmlUrl":349},"references\u002Ffile-conventions.md",3464,"https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002F.claude\u002Fskills\u002Fnextjs\u002Freferences\u002Ffile-conventions.md",{"path":351,"resourceType":310,"resourceTypeDesc":311,"sizeBytes":352,"sourceHtmlUrl":353},"references\u002Ffont.md",5196,"https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002F.claude\u002Fskills\u002Fnextjs\u002Freferences\u002Ffont.md",{"path":355,"resourceType":310,"resourceTypeDesc":311,"sizeBytes":356,"sourceHtmlUrl":357},"references\u002Ffunctions.md",4388,"https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002F.claude\u002Fskills\u002Fnextjs\u002Freferences\u002Ffunctions.md",{"path":359,"resourceType":310,"resourceTypeDesc":311,"sizeBytes":360,"sourceHtmlUrl":361},"references\u002Fhydration-error.md",1801,"https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002F.claude\u002Fskills\u002Fnextjs\u002Freferences\u002Fhydration-error.md",{"path":363,"resourceType":310,"resourceTypeDesc":311,"sizeBytes":364,"sourceHtmlUrl":365},"references\u002Fimage.md",3882,"https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002F.claude\u002Fskills\u002Fnextjs\u002Freferences\u002Fimage.md",{"path":367,"resourceType":310,"resourceTypeDesc":311,"sizeBytes":368,"sourceHtmlUrl":369},"references\u002Fmetadata.md",7140,"https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002F.claude\u002Fskills\u002Fnextjs\u002Freferences\u002Fmetadata.md",{"path":371,"resourceType":310,"resourceTypeDesc":311,"sizeBytes":372,"sourceHtmlUrl":373},"references\u002Fparallel-routes.md",7171,"https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002F.claude\u002Fskills\u002Fnextjs\u002Freferences\u002Fparallel-routes.md",{"path":375,"resourceType":310,"resourceTypeDesc":311,"sizeBytes":376,"sourceHtmlUrl":377},"references\u002Froute-handlers.md",3244,"https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002F.claude\u002Fskills\u002Fnextjs\u002Freferences\u002Froute-handlers.md",{"path":379,"resourceType":310,"resourceTypeDesc":311,"sizeBytes":380,"sourceHtmlUrl":381},"references\u002Frsc-boundaries.md",4309,"https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002F.claude\u002Fskills\u002Fnextjs\u002Freferences\u002Frsc-boundaries.md",{"path":383,"resourceType":310,"resourceTypeDesc":311,"sizeBytes":384,"sourceHtmlUrl":385},"references\u002Fruntime-selection.md",985,"https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002F.claude\u002Fskills\u002Fnextjs\u002Freferences\u002Fruntime-selection.md",{"path":387,"resourceType":310,"resourceTypeDesc":311,"sizeBytes":388,"sourceHtmlUrl":389},"references\u002Fscripts.md",3326,"https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002F.claude\u002Fskills\u002Fnextjs\u002Freferences\u002Fscripts.md",{"path":391,"resourceType":310,"resourceTypeDesc":311,"sizeBytes":392,"sourceHtmlUrl":393},"references\u002Fself-hosting.md",8334,"https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002F.claude\u002Fskills\u002Fnextjs\u002Freferences\u002Fself-hosting.md",{"path":395,"resourceType":310,"resourceTypeDesc":311,"sizeBytes":396,"sourceHtmlUrl":397},"references\u002Fsuspense-boundaries.md",1366,"https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002F.claude\u002Fskills\u002Fnextjs\u002Freferences\u002Fsuspense-boundaries.md",[399,417,425,445,465,497],{"skillNo":400,"name":401,"nameZh":6,"description":402,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":403,"categories":404,"keywords":405,"publishedAt":54},"01M6E263DRDCZ5AX01N6MDYC6Z","zustand","Zustand state management guide. Use when working with store code (src\u002Fstore\u002F**), implementing actions, managing state, or creating slices. Triggers on Zustand store development, state management questions, or action implementation.","https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002Fskills-archive\u002Fzustand\u002FSKILL.md",[],[401,406,407,408,409,410,411,412,413,50,414,415,416],"triggers","state management","zustand state","implementation","use","guide","management","src","state","code","development",{"skillNo":418,"name":419,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":420,"categories":421,"keywords":422,"publishedAt":54},"01M6E260QFP3ZMXY2Y6KTGZYXS","web-vitals","https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002Fskills-archive\u002Fweb-vitals\u002FSKILL.md",[],[423,424],"web vitals","web",{"skillNo":426,"name":67,"nameZh":6,"description":427,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":428,"categories":429,"keywords":431,"publishedAt":54},"01M6E25QEKXHH092S5RB0GKM0K","Vercel storage expert guidance — Blob, Edge Config, and Marketplace storage (Neon Postgres, Upstash Redis). Use when choosing, configuring, or using data storage with Vercel applications.","https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002Fskills-archive\u002Fvercel-storage\u002FSKILL.md",[430],{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},[432,433,434,435,436,437,438,5,439,75,47,440,38,39,40,441,44,442,443,444],"vercel","vercel storage","storage","supabase","api","mongodb","SET","database","click","postgres","up","auto","configure",{"skillNo":446,"name":79,"nameZh":6,"description":447,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":448,"categories":449,"keywords":452,"publishedAt":54},"01M6E25EC9YM4QM0KBQ2W5R1SC","Vercel Functions expert guidance — Serverless Functions, Edge Functions, Fluid Compute, streaming, Cron Jobs, and runtime configuration. Use when configuring, debugging, or optimizing server-side code running on Vercel.","https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002Fskills-archive\u002Fvercel-functions\u002FSKILL.md",[450,451],{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":27,"categoryName":28,"taxonomyType":29,"taxonomyTypeDesc":30},[453,432,454,455,43,42,456,37,38,39,41,457,458,459,460,461,462,463,464,44],"functions","vercel functions","local","time","vercel ai sdk","router","loop","server","logs","streaming","delete","create",{"skillNo":466,"name":467,"nameZh":6,"description":468,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":469,"categories":470,"keywords":482,"publishedAt":54},"01M6E25873YRYP96MSQK7E2D9X","ui-ux-pro-max","UI\u002FUX design intelligence for web and mobile. Includes 50+ styles, 161 color palettes, 57 font pairings, 161 product types, 99 UX guidelines, and 25 chart types across 10 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn\u002Fui, and HTML\u002FCSS). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, and check UI\u002FUX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, and mobile app. Elements: button, modal, navbar, sidebar, card, table, form, and chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, and flat design. Topics: color systems, accessibility, animation, layout, typography, font pairing, spacing, interaction states, shadow, and gradient. Integrations: shadcn\u002Fui MCP for component search and examples.","https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002Fskills-archive\u002Fui-ux-pro-max\u002FSKILL.md",[471,472,475,478,481],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":473,"categoryName":474,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":476,"categoryName":477,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",{"categoryNo":479,"categoryName":480,"taxonomyType":29,"taxonomyTypeDesc":30},"01JBSEEDCAT000000000000032","设计师",{"categoryNo":32,"categoryName":33,"taxonomyType":29,"taxonomyTypeDesc":30},[483,484,485,486,45,487,488,52,38,489,490,491,492,493,494,48,495,50,496,464],"ui ux pro max","ui","ux","max","MCP","design","card","chart","fix","projects","plan","improve","Animation","search",{"skillNo":498,"name":499,"nameZh":6,"description":500,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":501,"categories":502,"keywords":503,"publishedAt":54},"01M6E251G3FJSRB9019V20QK9X","turborepo","Turborepo monorepo build system guidance. Triggers on: turbo.json, task pipelines,\ndependsOn, caching, remote cache, the \"turbo\" CLI, --filter, --affected, CI optimization, environment\nvariables, internal packages, monorepo structure\u002Fbest practices, and boundaries.\n\nUse when user: configures tasks\u002Fworkflows\u002Fpipelines, creates packages, sets up\nmonorepo, shares code between apps, runs changed\u002Faffected packages, debugs cache,\nor has apps\u002Fpackages directories.","https:\u002F\u002Fgithub.com\u002FByeongminLee\u002Fnextjs-claude-code\u002Fblob\u002Fmain\u002Ftemplate\u002Fskills-archive\u002Fturborepo\u002FSKILL.md",[],[499,504,410,505,506,37,406,507,508,442,509,510,511,512,513,514,415,515,516,517],"cli","filter","environment variables","caching","structure","environment","monorepo","system","canary","Optimization","ci","packages","tasks","workflows"]