[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7BXZPFD6AAQZ7QQ6VFP2BPX":3,"skill-same:01M7BXZPFD6AAQZ7QQ6VFP2BPX":130},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":107,"commitSha":108,"skillDirectory":109,"forksCount":110,"repositoryHtmlUrl":111,"repositoryHomepageUrl":6,"ownerHtmlUrl":112,"ownerBlogUrl":113,"ownerDescription":114,"updatedAt":115,"install":116,"resources":129},"01M7BXZPFD6AAQZ7QQ6VFP2BPX","auth",null,"Authentication integration guidance — Clerk (native Vercel Marketplace), Descope, and Auth0 setup for Next.js applications. Covers middleware auth patterns, sign-in\u002Fsign-up flows, and Marketplace provisioning. Use when implementing user authentication.","CognitionAI\u002Fdevin-marketplace","CognitionAI","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F163493330?v=4","01M7BVSRD98NC4FG8T3EZS6V5M","Cognition","01M7BVSRDX111C2XPWJ0E6MY26",29,"MIT","https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fvercel\u002Fskills\u002Fauth\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: auth\ndescription: Authentication integration guidance — Clerk (native Vercel Marketplace), Descope, and Auth0 setup for Next.js applications. Covers middleware auth patterns, sign-in\u002Fsign-up flows, and Marketplace provisioning. Use when implementing user authentication.\nmetadata:\n  priority: 6\n  docs:\n    - \"https:\u002F\u002Fauthjs.dev\u002Fgetting-started\"\n    - \"https:\u002F\u002Fnextjs.org\u002Fdocs\u002Fapp\u002Fbuilding-your-application\u002Fauthentication\"\n  sitemap: \"https:\u002F\u002Fauthjs.dev\u002Fsitemap.xml\"\n  pathPatterns:\n    - 'middleware.ts'\n    - 'middleware.js'\n    - 'src\u002Fmiddleware.ts'\n    - 'src\u002Fmiddleware.js'\n    - 'clerk.config.*'\n    - 'app\u002Fsign-in\u002F**'\n    - 'app\u002Fsign-up\u002F**'\n    - 'src\u002Fapp\u002Fsign-in\u002F**'\n    - 'src\u002Fapp\u002Fsign-up\u002F**'\n    - 'app\u002F(auth)\u002F**'\n    - 'src\u002Fapp\u002F(auth)\u002F**'\n    - 'auth.config.*'\n    - 'auth.ts'\n    - 'auth.js'\n  bashPatterns:\n    - '\\bnpm\\s+(install|i|add)\\s+[^\\n]*@clerk\u002Fnextjs\\b'\n    - '\\bpnpm\\s+(install|i|add)\\s+[^\\n]*@clerk\u002Fnextjs\\b'\n    - '\\bbun\\s+(install|i|add)\\s+[^\\n]*@clerk\u002Fnextjs\\b'\n    - '\\byarn\\s+add\\s+[^\\n]*@clerk\u002Fnextjs\\b'\n    - '\\bnpm\\s+(install|i|add)\\s+[^\\n]*@descope\u002Fnextjs-sdk\\b'\n    - '\\bpnpm\\s+(install|i|add)\\s+[^\\n]*@descope\u002Fnextjs-sdk\\b'\n    - '\\bbun\\s+(install|i|add)\\s+[^\\n]*@descope\u002Fnextjs-sdk\\b'\n    - '\\byarn\\s+add\\s+[^\\n]*@descope\u002Fnextjs-sdk\\b'\n    - '\\bnpm\\s+(install|i|add)\\s+[^\\n]*@auth0\u002Fnextjs-auth0\\b'\n    - '\\bpnpm\\s+(install|i|add)\\s+[^\\n]*@auth0\u002Fnextjs-auth0\\b'\n    - '\\bbun\\s+(install|i|add)\\s+[^\\n]*@auth0\u002Fnextjs-auth0\\b'\n    - '\\byarn\\s+add\\s+[^\\n]*@auth0\u002Fnextjs-auth0\\b'\nvalidate:\n  -\n    pattern: 'VERCEL_CLIENT_(ID|SECRET)|vercel\\.com\u002Foauth\u002F(authorize|access_token|token)'\n    message: 'Hand-rolled Vercel OAuth detected. Use the Sign in with Vercel OIDC provider instead of manual token exchange.'\n    severity: recommended\n    skipIfFileContains: 'signInWithVercel|@vercel\u002Fauth'\nretrieval:\n  aliases:\n    - authentication\n    - login system\n    - sign in\n    - auth flow\n  intents:\n    - add auth\n    - protect routes\n    - manage sessions\n    - implement login\n    - secure api endpoints\n  entities:\n    - NextAuth\n    - Auth.js\n    - JWT\n    - OAuth\n    - session\n    - middleware\n    - getServerSession\n  examples:\n    - add login to my app\n    - protect this route with auth\n    - set up NextAuth\nchainTo:\n  -\n    pattern: 'export\\s+(default\\s+)?function\\s+middleware'\n    targetSkill: routing-middleware\n    message: 'Auth logic in middleware.ts — loading Routing Middleware guidance for proxy.ts migration in Next.js 16.'\n  -\n    pattern: 'from\\s+[''\\\"](jsonwebtoken)[''\"]|require\\s*\\(\\s*[''\\\"](jsonwebtoken)[''\"]|jwt\\.sign\\s*\\('\n    targetSkill: auth\n    message: 'Manual JWT handling with jsonwebtoken detected — use Clerk or Auth.js for managed auth with built-in JWT session handling, CSRF protection, and token rotation.'\n  -\n    pattern: 'from\\s+[''\\\"](next-auth)[''\"]|NextAuthOptions|authOptions\\s*:'\n    targetSkill: auth\n    message: 'Legacy next-auth (v4) pattern detected — loading auth guidance for Auth.js v5 migration with the new universal auth() helper.'\n  -\n    pattern: \"from\\\\s+['\\\"]@clerk\u002Fnextjs['\\\"]\"\n    targetSkill: auth\n    message: 'Clerk import detected — loading Auth guidance for Clerk v7 patterns, middleware setup, organization handling, and Vercel Marketplace integration.'\n    skipIfFileContains: 'clerkMiddleware|ClerkProvider'\n  -\n    pattern: \"bcrypt|argon2\"\n    targetSkill: auth\n    message: 'Manual password hashing detected (bcrypt\u002Fargon2) — use Clerk or Auth0 for managed authentication with built-in password hashing, rate limiting, and breach detection.'\n    skipIfFileContains: \"@clerk|@auth0\"\n---\n\n# Authentication Integrations\n\nYou are an expert in authentication for Vercel-deployed applications — covering Clerk (native Vercel Marketplace integration), Descope, and Auth0.\n\n## Clerk (Recommended — Native Marketplace Integration)\n\nClerk is a native Vercel Marketplace integration with auto-provisioned environment variables and unified billing. Current SDK: `@clerk\u002Fnextjs` v7 (Core 3, March 2026).\n\n### Install via Marketplace\n\n```bash\n# Install Clerk from Vercel Marketplace (auto-provisions env vars)\nvercel integration add clerk\n```\n\nAuto-provisioned environment variables:\n- `CLERK_SECRET_KEY` — server-side API key\n- `NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY` — client-side publishable key\n\n### SDK Setup\n\n```bash\n# Install the Clerk Next.js SDK\nnpm install @clerk\u002Fnextjs\n```\n\n### Middleware Configuration\n\n```ts\n\u002F\u002F middleware.ts\nimport { clerkMiddleware } from \"@clerk\u002Fnextjs\u002Fserver\";\n\nexport default clerkMiddleware();\n\nexport const config = {\n  matcher: [\n    \u002F\u002F Skip Next.js internals and static files\n    \"\u002F((?!_next|[^?]*\\\\.(?:html?|css|js(?!on)|jpe?g|webp|png|gif|svg|ttf|woff2?|ico|csv|docx?|xlsx?|zip|webmanifest)).*)\",\n    \u002F\u002F Always run for API routes\n    \"\u002F(api|trpc)(.*)\",\n  ],\n};\n```\n\n### Protect Routes\n\n```ts\n\u002F\u002F middleware.ts — protect specific routes\nimport { clerkMiddleware, createRouteMatcher } from \"@clerk\u002Fnextjs\u002Fserver\";\n\nconst isProtectedRoute = createRouteMatcher([\"\u002Fdashboard(.*)\", \"\u002Fapi(.*)\"]);\n\nexport default clerkMiddleware(async (auth, req) => {\n  if (isProtectedRoute(req)) {\n    await auth.protect();\n  }\n});\n```\n\n### Frontend API Proxy (Core 3)\n\nProxy Clerk's Frontend API through your own domain to avoid third-party requests:\n\n```ts\n\u002F\u002F middleware.ts\nexport default clerkMiddleware({\n  frontendApiProxy: { enabled: true },\n});\n```\n\n### Provider Setup\n\n```tsx\n\u002F\u002F app\u002Flayout.tsx\nimport { ClerkProvider } from \"@clerk\u002Fnextjs\";\n\nexport default function RootLayout({\n  children,\n}: {\n  children: React.ReactNode;\n}) {\n  return (\n    \u003CClerkProvider>\n      \u003Chtml lang=\"en\">\n        \u003Cbody>{children}\u003C\u002Fbody>\n      \u003C\u002Fhtml>\n    \u003C\u002FClerkProvider>\n  );\n}\n```\n\n### Sign-In and Sign-Up Pages\n\n```tsx\n\u002F\u002F app\u002Fsign-in\u002F[[...sign-in]]\u002Fpage.tsx\nimport { SignIn } from \"@clerk\u002Fnextjs\";\n\nexport default function Page() {\n  return \u003CSignIn \u002F>;\n}\n```\n\n```tsx\n\u002F\u002F app\u002Fsign-up\u002F[[...sign-up]]\u002Fpage.tsx\nimport { SignUp } from \"@clerk\u002Fnextjs\";\n\nexport default function Page() {\n  return \u003CSignUp \u002F>;\n}\n```\n\nAdd routing env vars to `.env.local`:\n\n```env\nNEXT_PUBLIC_CLERK_SIGN_IN_URL=\u002Fsign-in\nNEXT_PUBLIC_CLERK_SIGN_UP_URL=\u002Fsign-up\n```\n\n### Access User Data\n\n```tsx\n\u002F\u002F Server component\nimport { currentUser } from \"@clerk\u002Fnextjs\u002Fserver\";\n\nexport default async function Page() {\n  const user = await currentUser();\n  return \u003Cp>Hello, {user?.firstName}\u003C\u002Fp>;\n}\n```\n\n```tsx\n\u002F\u002F Client component\n\"use client\";\nimport { useUser } from \"@clerk\u002Fnextjs\";\n\nexport default function UserGreeting() {\n  const { user, isLoaded } = useUser();\n  if (!isLoaded) return null;\n  return \u003Cp>Hello, {user?.firstName}\u003C\u002Fp>;\n}\n```\n\n### API Route Protection\n\n```ts\n\u002F\u002F app\u002Fapi\u002Fprotected\u002Froute.ts\nimport { auth } from \"@clerk\u002Fnextjs\u002Fserver\";\n\nexport async function GET() {\n  const { userId } = await auth();\n  if (!userId) {\n    return Response.json({ error: \"Unauthorized\" }, { status: 401 });\n  }\n  return Response.json({ userId });\n}\n```\n\n## Descope\n\nDescope is available on the Vercel Marketplace with native integration support.\n\n### Install via Marketplace\n\n```bash\nvercel integration add descope\n```\n\n### SDK Setup\n\n```bash\nnpm install @descope\u002Fnextjs-sdk\n```\n\n### Provider and Middleware\n\n```tsx\n\u002F\u002F app\u002Flayout.tsx\nimport { AuthProvider } from \"@descope\u002Fnextjs-sdk\";\n\nexport default function RootLayout({\n  children,\n}: {\n  children: React.ReactNode;\n}) {\n  return (\n    \u003CAuthProvider projectId={process.env.NEXT_PUBLIC_DESCOPE_PROJECT_ID!}>\n      \u003Chtml lang=\"en\">\n        \u003Cbody>{children}\u003C\u002Fbody>\n      \u003C\u002Fhtml>\n    \u003C\u002FAuthProvider>\n  );\n}\n```\n\n```ts\n\u002F\u002F middleware.ts\nimport { authMiddleware } from \"@descope\u002Fnextjs-sdk\u002Fserver\";\n\nexport default authMiddleware({\n  projectId: process.env.DESCOPE_PROJECT_ID!,\n  publicRoutes: [\"\u002F\", \"\u002Fsign-in\"],\n});\n```\n\n### Sign-In Flow\n\n```tsx\n\"use client\";\nimport { Descope } from \"@descope\u002Fnextjs-sdk\";\n\nexport default function SignInPage() {\n  return \u003CDescope flowId=\"sign-up-or-in\" \u002F>;\n}\n```\n\n## Auth0\n\nAuth0 provides a mature authentication platform with extensive identity provider support.\n\n### SDK Setup\n\n```bash\nnpm install @auth0\u002Fnextjs-auth0\n```\n\n### Configuration\n\n```ts\n\u002F\u002F lib\u002Fauth0.ts\nimport { Auth0Client } from \"@auth0\u002Fnextjs-auth0\u002Fserver\";\n\nexport const auth0 = new Auth0Client();\n```\n\nRequired environment variables:\n\n```env\nAUTH0_SECRET=\u003Crandom-secret>\nAUTH0_BASE_URL=http:\u002F\u002Flocalhost:3000\nAUTH0_ISSUER_BASE_URL=https:\u002F\u002Fyour-tenant.auth0.com\nAUTH0_CLIENT_ID=\u003Cclient-id>\nAUTH0_CLIENT_SECRET=\u003Cclient-secret>\n```\n\n### Middleware\n\n```ts\n\u002F\u002F middleware.ts\nimport { auth0 } from \"@\u002Flib\u002Fauth0\";\nimport { NextRequest, NextResponse } from \"next\u002Fserver\";\n\nexport async function middleware(request: NextRequest) {\n  return await auth0.middleware(request);\n}\n\nexport const config = {\n  matcher: [\n    \"\u002F((?!_next\u002Fstatic|_next\u002Fimage|favicon.ico|sitemap.xml|robots.txt).*)\",\n  ],\n};\n```\n\n### Access Session Data\n\n```tsx\n\u002F\u002F Server component\nimport { auth0 } from \"@\u002Flib\u002Fauth0\";\n\nexport default async function Page() {\n  const session = await auth0.getSession();\n  return session ? (\n    \u003Cp>Hello, {session.user.name}\u003C\u002Fp>\n  ) : (\n    \u003Ca href=\"\u002Fauth\u002Flogin\">Log in\u003C\u002Fa>\n  );\n}\n```\n\n## Decision Matrix\n\n| Need | Recommended | Why |\n|------|------------|-----|\n| Fastest setup on Vercel | Clerk | Native Marketplace, auto-provisioned env vars |\n| Passwordless \u002F social login flows | Descope | Visual flow builder, Marketplace native |\n| Enterprise SSO \u002F SAML \u002F multi-tenant | Auth0 | Deep enterprise identity support |\n| Pre-built UI components | Clerk | Drop-in `\u003CSignIn \u002F>`, `\u003CUserButton \u002F>` |\n| Vercel unified billing | Clerk or Descope | Both are native Marketplace integrations |\n\n## Clerk Core 3 Breaking Changes (March 2026)\n\nClerk provides an upgrade CLI that scans your codebase and applies codemods: `npx @clerk\u002Fupgrade`. Requires **Node.js 20.9.0+**.\n\n- **`auth()` is async** — always use `const { userId } = await auth()`, not synchronous\n- **`auth.protect()` moved** — use `await auth.protect()` directly, not from the return value of `auth()`\n- **`clerkClient()` is async** — use `await clerkClient()` in middleware handlers\n- **`authMiddleware()` removed** — migrate to `clerkMiddleware()`\n- **`@clerk\u002Ftypes` deprecated** — import types from SDK subpath exports: `import type { UserResource } from '@clerk\u002Freact\u002Ftypes'` (works from any SDK package)\n- **`ClerkProvider` no longer forces dynamic rendering** — pass the `dynamic` prop if needed\n- **Cache components** — when using Next.js cache components, place `\u003CClerkProvider>` inside `\u003Cbody>`, not wrapping `\u003Chtml>`\n- **Satellite domains** — new `satelliteAutoSync` option skips handshake redirects when no session cookies exist\n- **Smaller bundles** — React is now shared across framework SDKs (~50KB gzipped savings)\n- **Better offline handling** — `getToken()` now correctly distinguishes signed-out from offline states\n\n## Cross-References\n\n- **Marketplace install and env var provisioning** → `⤳ skill: marketplace`\n- **Middleware routing patterns** → `⤳ skill: routing-middleware`\n- **Environment variable management** → `⤳ skill: env-vars`\n\n## Official Documentation\n\n- [Clerk + Vercel Marketplace](https:\u002F\u002Fclerk.com\u002Fdocs\u002Fdeployments\u002Fvercel)\n- [Clerk Next.js Quickstart](https:\u002F\u002Fclerk.com\u002Fdocs\u002Fquickstarts\u002Fnextjs)\n- [Descope Next.js SDK](https:\u002F\u002Fdocs.descope.com\u002Fgetting-started\u002Fnextjs)\n- [Auth0 Next.js SDK](https:\u002F\u002Fauth0.com\u002Fdocs\u002Fquickstart\u002Fwebapp\u002Fnextjs)\n","# Authentication Integrations\n\nYou are an expert in authentication for Vercel-deployed applications — covering Clerk (native Vercel Marketplace integration), Descope, and Auth0.\n\n## Clerk (Recommended — Native Marketplace Integration)\n\nClerk is a native Vercel Marketplace integration with auto-provisioned environment variables and unified billing. Current SDK: `@clerk\u002Fnextjs` v7 (Core 3, March 2026).\n\n### Install via Marketplace\n\n```bash\n# Install Clerk from Vercel Marketplace (auto-provisions env vars)\nvercel integration add clerk\n```\n\nAuto-provisioned environment variables:\n- `CLERK_SECRET_KEY` — server-side API key\n- `NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY` — client-side publishable key\n\n### SDK Setup\n\n```bash\n# Install the Clerk Next.js SDK\nnpm install @clerk\u002Fnextjs\n```\n\n### Middleware Configuration\n\n```ts\n\u002F\u002F middleware.ts\nimport { clerkMiddleware } from \"@clerk\u002Fnextjs\u002Fserver\";\n\nexport default clerkMiddleware();\n\nexport const config = {\n  matcher: [\n    \u002F\u002F Skip Next.js internals and static files\n    \"\u002F((?!_next|[^?]*\\\\.(?:html?|css|js(?!on)|jpe?g|webp|png|gif|svg|ttf|woff2?|ico|csv|docx?|xlsx?|zip|webmanifest)).*)\",\n    \u002F\u002F Always run for API routes\n    \"\u002F(api|trpc)(.*)\",\n  ],\n};\n```\n\n### Protect Routes\n\n```ts\n\u002F\u002F middleware.ts — protect specific routes\nimport { clerkMiddleware, createRouteMatcher } from \"@clerk\u002Fnextjs\u002Fserver\";\n\nconst isProtectedRoute = createRouteMatcher([\"\u002Fdashboard(.*)\", \"\u002Fapi(.*)\"]);\n\nexport default clerkMiddleware(async (auth, req) => {\n  if (isProtectedRoute(req)) {\n    await auth.protect();\n  }\n});\n```\n\n### Frontend API Proxy (Core 3)\n\nProxy Clerk's Frontend API through your own domain to avoid third-party requests:\n\n```ts\n\u002F\u002F middleware.ts\nexport default clerkMiddleware({\n  frontendApiProxy: { enabled: true },\n});\n```\n\n### Provider Setup\n\n```tsx\n\u002F\u002F app\u002Flayout.tsx\nimport { ClerkProvider } from \"@clerk\u002Fnextjs\";\n\nexport default function RootLayout({\n  children,\n}: {\n  children: React.ReactNode;\n}) {\n  return (\n    \u003CClerkProvider>\n      \u003Chtml lang=\"en\">\n        \u003Cbody>{children}\u003C\u002Fbody>\n      \u003C\u002Fhtml>\n    \u003C\u002FClerkProvider>\n  );\n}\n```\n\n### Sign-In and Sign-Up Pages\n\n```tsx\n\u002F\u002F app\u002Fsign-in\u002F[[...sign-in]]\u002Fpage.tsx\nimport { SignIn } from \"@clerk\u002Fnextjs\";\n\nexport default function Page() {\n  return \u003CSignIn \u002F>;\n}\n```\n\n```tsx\n\u002F\u002F app\u002Fsign-up\u002F[[...sign-up]]\u002Fpage.tsx\nimport { SignUp } from \"@clerk\u002Fnextjs\";\n\nexport default function Page() {\n  return \u003CSignUp \u002F>;\n}\n```\n\nAdd routing env vars to `.env.local`:\n\n```env\nNEXT_PUBLIC_CLERK_SIGN_IN_URL=\u002Fsign-in\nNEXT_PUBLIC_CLERK_SIGN_UP_URL=\u002Fsign-up\n```\n\n### Access User Data\n\n```tsx\n\u002F\u002F Server component\nimport { currentUser } from \"@clerk\u002Fnextjs\u002Fserver\";\n\nexport default async function Page() {\n  const user = await currentUser();\n  return \u003Cp>Hello, {user?.firstName}\u003C\u002Fp>;\n}\n```\n\n```tsx\n\u002F\u002F Client component\n\"use client\";\nimport { useUser } from \"@clerk\u002Fnextjs\";\n\nexport default function UserGreeting() {\n  const { user, isLoaded } = useUser();\n  if (!isLoaded) return null;\n  return \u003Cp>Hello, {user?.firstName}\u003C\u002Fp>;\n}\n```\n\n### API Route Protection\n\n```ts\n\u002F\u002F app\u002Fapi\u002Fprotected\u002Froute.ts\nimport { auth } from \"@clerk\u002Fnextjs\u002Fserver\";\n\nexport async function GET() {\n  const { userId } = await auth();\n  if (!userId) {\n    return Response.json({ error: \"Unauthorized\" }, { status: 401 });\n  }\n  return Response.json({ userId });\n}\n```\n\n## Descope\n\nDescope is available on the Vercel Marketplace with native integration support.\n\n### Install via Marketplace\n\n```bash\nvercel integration add descope\n```\n\n### SDK Setup\n\n```bash\nnpm install @descope\u002Fnextjs-sdk\n```\n\n### Provider and Middleware\n\n```tsx\n\u002F\u002F app\u002Flayout.tsx\nimport { AuthProvider } from \"@descope\u002Fnextjs-sdk\";\n\nexport default function RootLayout({\n  children,\n}: {\n  children: React.ReactNode;\n}) {\n  return (\n    \u003CAuthProvider projectId={process.env.NEXT_PUBLIC_DESCOPE_PROJECT_ID!}>\n      \u003Chtml lang=\"en\">\n        \u003Cbody>{children}\u003C\u002Fbody>\n      \u003C\u002Fhtml>\n    \u003C\u002FAuthProvider>\n  );\n}\n```\n\n```ts\n\u002F\u002F middleware.ts\nimport { authMiddleware } from \"@descope\u002Fnextjs-sdk\u002Fserver\";\n\nexport default authMiddleware({\n  projectId: process.env.DESCOPE_PROJECT_ID!,\n  publicRoutes: [\"\u002F\", \"\u002Fsign-in\"],\n});\n```\n\n### Sign-In Flow\n\n```tsx\n\"use client\";\nimport { Descope } from \"@descope\u002Fnextjs-sdk\";\n\nexport default function SignInPage() {\n  return \u003CDescope flowId=\"sign-up-or-in\" \u002F>;\n}\n```\n\n## Auth0\n\nAuth0 provides a mature authentication platform with extensive identity provider support.\n\n### SDK Setup\n\n```bash\nnpm install @auth0\u002Fnextjs-auth0\n```\n\n### Configuration\n\n```ts\n\u002F\u002F lib\u002Fauth0.ts\nimport { Auth0Client } from \"@auth0\u002Fnextjs-auth0\u002Fserver\";\n\nexport const auth0 = new Auth0Client();\n```\n\nRequired environment variables:\n\n```env\nAUTH0_SECRET=\u003Crandom-secret>\nAUTH0_BASE_URL=http:\u002F\u002Flocalhost:3000\nAUTH0_ISSUER_BASE_URL=https:\u002F\u002Fyour-tenant.auth0.com\nAUTH0_CLIENT_ID=\u003Cclient-id>\nAUTH0_CLIENT_SECRET=\u003Cclient-secret>\n```\n\n### Middleware\n\n```ts\n\u002F\u002F middleware.ts\nimport { auth0 } from \"@\u002Flib\u002Fauth0\";\nimport { NextRequest, NextResponse } from \"next\u002Fserver\";\n\nexport async function middleware(request: NextRequest) {\n  return await auth0.middleware(request);\n}\n\nexport const config = {\n  matcher: [\n    \"\u002F((?!_next\u002Fstatic|_next\u002Fimage|favicon.ico|sitemap.xml|robots.txt).*)\",\n  ],\n};\n```\n\n### Access Session Data\n\n```tsx\n\u002F\u002F Server component\nimport { auth0 } from \"@\u002Flib\u002Fauth0\";\n\nexport default async function Page() {\n  const session = await auth0.getSession();\n  return session ? (\n    \u003Cp>Hello, {session.user.name}\u003C\u002Fp>\n  ) : (\n    \u003Ca href=\"\u002Fauth\u002Flogin\">Log in\u003C\u002Fa>\n  );\n}\n```\n\n## Decision Matrix\n\n| Need | Recommended | Why |\n|------|------------|-----|\n| Fastest setup on Vercel | Clerk | Native Marketplace, auto-provisioned env vars |\n| Passwordless \u002F social login flows | Descope | Visual flow builder, Marketplace native |\n| Enterprise SSO \u002F SAML \u002F multi-tenant | Auth0 | Deep enterprise identity support |\n| Pre-built UI components | Clerk | Drop-in `\u003CSignIn \u002F>`, `\u003CUserButton \u002F>` |\n| Vercel unified billing | Clerk or Descope | Both are native Marketplace integrations |\n\n## Clerk Core 3 Breaking Changes (March 2026)\n\nClerk provides an upgrade CLI that scans your codebase and applies codemods: `npx @clerk\u002Fupgrade`. Requires **Node.js 20.9.0+**.\n\n- **`auth()` is async** — always use `const { userId } = await auth()`, not synchronous\n- **`auth.protect()` moved** — use `await auth.protect()` directly, not from the return value of `auth()`\n- **`clerkClient()` is async** — use `await clerkClient()` in middleware handlers\n- **`authMiddleware()` removed** — migrate to `clerkMiddleware()`\n- **`@clerk\u002Ftypes` deprecated** — import types from SDK subpath exports: `import type { UserResource } from '@clerk\u002Freact\u002Ftypes'` (works from any SDK package)\n- **`ClerkProvider` no longer forces dynamic rendering** — pass the `dynamic` prop if needed\n- **Cache components** — when using Next.js cache components, place `\u003CClerkProvider>` inside `\u003Cbody>`, not wrapping `\u003Chtml>`\n- **Satellite domains** — new `satelliteAutoSync` option skips handshake redirects when no session cookies exist\n- **Smaller bundles** — React is now shared across framework SDKs (~50KB gzipped savings)\n- **Better offline handling** — `getToken()` now correctly distinguishes signed-out from offline states\n\n## Cross-References\n\n- **Marketplace install and env var provisioning** → `⤳ skill: marketplace`\n- **Middleware routing patterns** → `⤳ skill: routing-middleware`\n- **Environment variable management** → `⤳ skill: env-vars`\n\n## Official Documentation\n\n- [Clerk + Vercel Marketplace](https:\u002F\u002Fclerk.com\u002Fdocs\u002Fdeployments\u002Fvercel)\n- [Clerk Next.js Quickstart](https:\u002F\u002Fclerk.com\u002Fdocs\u002Fquickstarts\u002Fnextjs)\n- [Descope Next.js SDK](https:\u002F\u002Fdocs.descope.com\u002Fgetting-started\u002Fnextjs)\n- [Auth0 Next.js SDK](https:\u002F\u002Fauth0.com\u002Fdocs\u002Fquickstart\u002Fwebapp\u002Fnextjs)\n",{"name":5,"chainTo":24,"metadata":43,"validate":77,"retrieval":83,"description":7},[25,29,32,35,39],{"message":26,"pattern":27,"targetSkill":28},"Auth logic in middleware.ts — loading Routing Middleware guidance for proxy.ts migration in Next.js 16.","export\\s+(default\\s+)?function\\s+middleware","routing-middleware",{"message":30,"pattern":31,"targetSkill":5},"Manual JWT handling with jsonwebtoken detected — use Clerk or Auth.js for managed auth with built-in JWT session handling, CSRF protection, and token rotation.","from\\s+['\\\"](jsonwebtoken)['\"]|require\\s*\\(\\s*['\\\"](jsonwebtoken)['\"]|jwt\\.sign\\s*\\(",{"message":33,"pattern":34,"targetSkill":5},"Legacy next-auth (v4) pattern detected — loading auth guidance for Auth.js v5 migration with the new universal auth() helper.","from\\s+['\\\"](next-auth)['\"]|NextAuthOptions|authOptions\\s*:",{"message":36,"pattern":37,"targetSkill":5,"skipIfFileContains":38},"Clerk import detected — loading Auth guidance for Clerk v7 patterns, middleware setup, organization handling, and Vercel Marketplace integration.","from\\s+['\"]@clerk\u002Fnextjs['\"]","clerkMiddleware|ClerkProvider",{"message":40,"pattern":41,"targetSkill":5,"skipIfFileContains":42},"Manual password hashing detected (bcrypt\u002Fargon2) — use Clerk or Auth0 for managed authentication with built-in password hashing, rate limiting, and breach detection.","bcrypt|argon2","@clerk|@auth0",{"docs":44,"sitemap":47,"priority":48,"bashPatterns":49,"pathPatterns":62},[45,46],"https:\u002F\u002Fauthjs.dev\u002Fgetting-started","https:\u002F\u002Fnextjs.org\u002Fdocs\u002Fapp\u002Fbuilding-your-application\u002Fauthentication","https:\u002F\u002Fauthjs.dev\u002Fsitemap.xml",6,[50,51,52,53,54,55,56,57,58,59,60,61],"\\bnpm\\s+(install|i|add)\\s+[^\\n]*@clerk\u002Fnextjs\\b","\\bpnpm\\s+(install|i|add)\\s+[^\\n]*@clerk\u002Fnextjs\\b","\\bbun\\s+(install|i|add)\\s+[^\\n]*@clerk\u002Fnextjs\\b","\\byarn\\s+add\\s+[^\\n]*@clerk\u002Fnextjs\\b","\\bnpm\\s+(install|i|add)\\s+[^\\n]*@descope\u002Fnextjs-sdk\\b","\\bpnpm\\s+(install|i|add)\\s+[^\\n]*@descope\u002Fnextjs-sdk\\b","\\bbun\\s+(install|i|add)\\s+[^\\n]*@descope\u002Fnextjs-sdk\\b","\\byarn\\s+add\\s+[^\\n]*@descope\u002Fnextjs-sdk\\b","\\bnpm\\s+(install|i|add)\\s+[^\\n]*@auth0\u002Fnextjs-auth0\\b","\\bpnpm\\s+(install|i|add)\\s+[^\\n]*@auth0\u002Fnextjs-auth0\\b","\\bbun\\s+(install|i|add)\\s+[^\\n]*@auth0\u002Fnextjs-auth0\\b","\\byarn\\s+add\\s+[^\\n]*@auth0\u002Fnextjs-auth0\\b",[63,64,65,66,67,68,69,70,71,72,73,74,75,76],"middleware.ts","middleware.js","src\u002Fmiddleware.ts","src\u002Fmiddleware.js","clerk.config.*","app\u002Fsign-in\u002F**","app\u002Fsign-up\u002F**","src\u002Fapp\u002Fsign-in\u002F**","src\u002Fapp\u002Fsign-up\u002F**","app\u002F(auth)\u002F**","src\u002Fapp\u002F(auth)\u002F**","auth.config.*","auth.ts","auth.js",[78],{"message":79,"pattern":80,"severity":81,"skipIfFileContains":82},"Hand-rolled Vercel OAuth detected. Use the Sign in with Vercel OIDC provider instead of manual token exchange.","VERCEL_CLIENT_(ID|SECRET)|vercel\\.com\u002Foauth\u002F(authorize|access_token|token)","recommended","signInWithVercel|@vercel\u002Fauth",{"aliases":84,"intents":89,"entities":95,"examples":103},[85,86,87,88],"authentication","login system","sign in","auth flow",[90,91,92,93,94],"add auth","protect routes","manage sessions","implement login","secure api endpoints",[96,97,98,99,100,101,102],"NextAuth","Auth.js","JWT","OAuth","session","middleware","getServerSession",[104,105,106],"add login to my app","protect this route with auth","set up NextAuth","main","9836d94e88404aabb682086405c2aa9cba7657ac","plugins\u002Fvercel\u002Fskills\u002Fauth",156,"https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace","https:\u002F\u002Fgithub.com\u002FCognitionAI","https:\u002F\u002Fcognition.ai\u002F","Makers of Devin, the AI software engineer.","2026-11-13 07:08:23",{"source":8,"skillName":5,"commands":117,"prompt":127,"zipAvailable":128},[118,121,124],{"tool":119,"command":120},"npx","npx skills add CognitionAI\u002Fdevin-marketplace --skill auth",{"tool":122,"command":123},"bunx","bunx skills add CognitionAI\u002Fdevin-marketplace --skill auth",{"tool":125,"command":126},"pnpm","pnpm dlx skills add CognitionAI\u002Fdevin-marketplace --skill auth","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fvercel\u002Fskills\u002Fauth\u002FSKILL.md",true,[],[131,137,144,150,157,164],{"skillNo":132,"name":133,"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":134,"categories":135,"keywords":136,"publishedAt":19},"01M7BYC4AJGM98P2G9JH7QS24Z","business-data","https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fwindsor-ai\u002Fskills\u002Fbusiness-data\u002FSKILL.md",[],[],{"skillNo":138,"name":139,"nameZh":6,"description":140,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":141,"categories":142,"keywords":143,"publishedAt":19},"01M7BYBZ0CD4CBCPZHRZ551BNK","workflow","Creates durable, resumable workflows using Vercel's Workflow SDK. Use when building workflows that need to survive restarts, pause for external events, retry on failure, or coordinate multi-step operations over time. Triggers on mentions of \"workflow\", \"durable functions\", \"resumable\", \"workflow sdk\", \"queue\", \"event\", \"push\", \"subscribe\", or step-based orchestration.","https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fvercel\u002Fskills\u002Fworkflow\u002Fupstream\u002FSKILL.md",[],[],{"skillNo":145,"name":139,"nameZh":6,"description":146,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":147,"categories":148,"keywords":149,"publishedAt":19},"01M7BYB1XSZHKHD8JZTQJ62JN0","Vercel Workflow SDK expert guidance. Use when building durable workflows, long-running tasks, API routes or agents that need pause\u002Fresume, retries, step-based execution, or crash-safe orchestration with Vercel Workflow.","https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fvercel\u002Fskills\u002Fworkflow\u002FSKILL.md",[],[],{"skillNo":151,"name":152,"nameZh":6,"description":153,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":154,"categories":155,"keywords":156,"publishedAt":19},"01M7BYASGMK935J33E21N5WTW0","verification","Full-story verification — infers what the user is building, then verifies the complete flow end-to-end: browser → API → data → response. Triggers on dev server start and 'why isn't this working' signals.","https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fvercel\u002Fskills\u002Fverification\u002FSKILL.md",[],[],{"skillNo":158,"name":159,"nameZh":6,"description":160,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":161,"categories":162,"keywords":163,"publishedAt":19},"01M7BY9WJERKSKEH9HK6E71GW2","vercel-storage","Vercel storage expert guidance — Blob, Global Config (formerly Edge Config), and Marketplace storage (Neon Postgres, Upstash Redis). Use when choosing, configuring, or using data storage with Vercel applications.","https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fvercel\u002Fskills\u002Fvercel-storage\u002FSKILL.md",[],[],{"skillNo":165,"name":166,"nameZh":6,"description":167,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":168,"categories":169,"keywords":170,"publishedAt":19},"01M7BY9N034894YV2J9DCRZHYS","vercel-services","Configure and troubleshoot Vercel Services for multiple frontends and backends in one project. Use when composing a polyglot or multi-service application on one Vercel deployment; defining the `services` key, service-targeted rewrites, or service bindings in `vercel.json`; or running all services with `vercel dev`.","https:\u002F\u002Fgithub.com\u002FCognitionAI\u002Fdevin-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fvercel\u002Fskills\u002Fvercel-services\u002FSKILL.md",[],[]]