[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CHH6F4ZTTH9V5CYVMR3G69":3,"skill-same:01M6CHH6F4ZTTH9V5CYVMR3G69":90},{"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":43,"linkOnly":44,"markdownContent":45,"markdownBody":46,"frontMatter":47,"refName":52,"commitSha":53,"skillDirectory":54,"forksCount":55,"repositoryHtmlUrl":56,"repositoryHomepageUrl":6,"ownerHtmlUrl":57,"ownerBlogUrl":58,"ownerDescription":59,"updatedAt":60,"install":61,"resources":74},"01M6CHH6F4ZTTH9V5CYVMR3G69","clerk-migration-deep-dive",null,"Migrate from other authentication providers to Clerk.\nUse when migrating from Auth0, Firebase, Supabase Auth, NextAuth,\nor custom authentication solutions.\nTrigger with phrases like \"migrate to clerk\", \"clerk migration\",\n\"switch to clerk\", \"auth0 to clerk\", \"firebase auth to clerk\".","Dicklesworthstone\u002Fpi_agent_rust","Dicklesworthstone","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F35050222?v=4","01M6CG26AR942CSVMN1M5E3DSE","Jeff Emanuel","01M6CG26EPP71PSHW1VDS71121",1992,"MIT","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fclerk-pack\u002Fskills\u002Fclerk-migration-deep-dive\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42],"deep dive","deep","clerk migration deep dive","clerk","migration","use","solutions","when","auth0","trigger","io","switch","auth","edit","write","read","grep","migrate","Bash","firebase","Providers","supabase","npm","authentication","2026-11-10 10:12:30",false,"---\nname: clerk-migration-deep-dive\ndescription: |\n  Migrate from other authentication providers to Clerk.\n  Use when migrating from Auth0, Firebase, Supabase Auth, NextAuth,\n  or custom authentication solutions.\n  Trigger with phrases like \"migrate to clerk\", \"clerk migration\",\n  \"switch to clerk\", \"auth0 to clerk\", \"firebase auth to clerk\".\nallowed-tools: Read, Write, Edit, Bash(npm:*), Grep\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\n---\n\n# Clerk Migration Deep Dive\n\n## Overview\nComprehensive guide to migrating from other authentication providers to Clerk.\n\n## Prerequisites\n- Current auth provider access\n- User data export capability\n- Clerk account and API keys\n- Migration timeline planned\n\n## Migration Sources\n\n### 1. Auth0 to Clerk\n\n#### Step 1: Export Users from Auth0\n```bash\n# Using Auth0 Management API\ncurl -X GET \"https:\u002F\u002FYOUR_DOMAIN.auth0.com\u002Fapi\u002Fv2\u002Fusers\" \\\n  -H \"Authorization: Bearer YOUR_MGMT_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  > auth0-users.json\n```\n\n#### Step 2: Transform User Data\n```typescript\n\u002F\u002F scripts\u002Ftransform-auth0-users.ts\ninterface Auth0User {\n  user_id: string\n  email: string\n  email_verified: boolean\n  name: string\n  given_name?: string\n  family_name?: string\n  picture?: string\n  created_at: string\n  last_login?: string\n}\n\ninterface ClerkImportUser {\n  external_id: string\n  email_addresses: Array\u003C{\n    email_address: string\n    verified: boolean\n  }>\n  first_name?: string\n  last_name?: string\n  image_url?: string\n  created_at: string\n  public_metadata?: Record\u003Cstring, any>\n}\n\nfunction transformAuth0ToClerk(auth0User: Auth0User): ClerkImportUser {\n  return {\n    external_id: auth0User.user_id,\n    email_addresses: [{\n      email_address: auth0User.email,\n      verified: auth0User.email_verified\n    }],\n    first_name: auth0User.given_name,\n    last_name: auth0User.family_name,\n    image_url: auth0User.picture,\n    created_at: auth0User.created_at,\n    public_metadata: {\n      migrated_from: 'auth0',\n      migrated_at: new Date().toISOString()\n    }\n  }\n}\n```\n\n#### Step 3: Import to Clerk\n```typescript\n\u002F\u002F scripts\u002Fimport-to-clerk.ts\nimport { clerkClient } from '@clerk\u002Fnextjs\u002Fserver'\n\nasync function importUsers(users: ClerkImportUser[]) {\n  const client = await clerkClient()\n  const results = { success: 0, failed: 0, errors: [] as string[] }\n\n  for (const user of users) {\n    try {\n      await client.users.createUser({\n        externalId: user.external_id,\n        emailAddress: [user.email_addresses[0].email_address],\n        firstName: user.first_name,\n        lastName: user.last_name,\n        publicMetadata: user.public_metadata,\n        skipPasswordRequirement: true \u002F\u002F User will set password on first login\n      })\n      results.success++\n    } catch (error: any) {\n      results.failed++\n      results.errors.push(`${user.external_id}: ${error.message}`)\n    }\n\n    \u002F\u002F Rate limiting\n    await new Promise(r => setTimeout(r, 100))\n  }\n\n  return results\n}\n```\n\n### 2. Firebase Auth to Clerk\n\n#### Step 1: Export from Firebase\n```typescript\n\u002F\u002F scripts\u002Fexport-firebase-users.ts\nimport * as admin from 'firebase-admin'\n\nadmin.initializeApp({\n  credential: admin.credential.cert(require('.\u002Fservice-account.json'))\n})\n\nasync function exportFirebaseUsers() {\n  const users: admin.auth.UserRecord[] = []\n  let nextPageToken: string | undefined\n\n  do {\n    const result = await admin.auth().listUsers(1000, nextPageToken)\n    users.push(...result.users)\n    nextPageToken = result.pageToken\n  } while (nextPageToken)\n\n  return users\n}\n```\n\n#### Step 2: Transform and Import\n```typescript\n\u002F\u002F scripts\u002Fmigrate-firebase-to-clerk.ts\nimport { clerkClient } from '@clerk\u002Fnextjs\u002Fserver'\n\ninterface FirebaseUser {\n  uid: string\n  email?: string\n  emailVerified: boolean\n  displayName?: string\n  photoURL?: string\n  phoneNumber?: string\n  disabled: boolean\n  metadata: {\n    creationTime: string\n    lastSignInTime: string\n  }\n  providerData: Array\u003C{\n    providerId: string\n    uid: string\n  }>\n}\n\nasync function migrateFirebaseUsers(firebaseUsers: FirebaseUser[]) {\n  const client = await clerkClient()\n\n  for (const fbUser of firebaseUsers) {\n    if (fbUser.disabled || !fbUser.email) continue\n\n    try {\n      await client.users.createUser({\n        externalId: fbUser.uid,\n        emailAddress: [fbUser.email],\n        firstName: fbUser.displayName?.split(' ')[0],\n        lastName: fbUser.displayName?.split(' ').slice(1).join(' '),\n        publicMetadata: {\n          migrated_from: 'firebase',\n          firebase_uid: fbUser.uid,\n          providers: fbUser.providerData.map(p => p.providerId)\n        },\n        skipPasswordRequirement: true\n      })\n    } catch (error) {\n      console.error(`Failed to migrate ${fbUser.uid}:`, error)\n    }\n  }\n}\n```\n\n### 3. NextAuth.js to Clerk\n\n#### Step 1: Database Migration\n```typescript\n\u002F\u002F scripts\u002Fmigrate-nextauth-db.ts\n\u002F\u002F Assuming Prisma with NextAuth schema\n\nasync function migrateNextAuthUsers() {\n  \u002F\u002F Get all users from NextAuth database\n  const nextAuthUsers = await prisma.user.findMany({\n    include: {\n      accounts: true,\n      sessions: true\n    }\n  })\n\n  const client = await clerkClient()\n\n  for (const user of nextAuthUsers) {\n    try {\n      \u002F\u002F Create user in Clerk\n      const clerkUser = await client.users.createUser({\n        externalId: user.id,\n        emailAddress: user.email ? [user.email] : [],\n        firstName: user.name?.split(' ')[0],\n        lastName: user.name?.split(' ').slice(1).join(' '),\n        publicMetadata: {\n          migrated_from: 'nextauth',\n          nextauth_id: user.id\n        },\n        skipPasswordRequirement: true\n      })\n\n      \u002F\u002F Update local database with new Clerk ID\n      await prisma.user.update({\n        where: { id: user.id },\n        data: { clerkId: clerkUser.id }\n      })\n    } catch (error) {\n      console.error(`Failed to migrate ${user.id}:`, error)\n    }\n  }\n}\n```\n\n#### Step 2: Update Application Code\n```typescript\n\u002F\u002F BEFORE: NextAuth\nimport { getSession } from 'next-auth\u002Freact'\n\nexport async function getServerSideProps(context) {\n  const session = await getSession(context)\n  if (!session) {\n    return { redirect: { destination: '\u002Flogin' } }\n  }\n  return { props: { user: session.user } }\n}\n\n\u002F\u002F AFTER: Clerk\nimport { auth } from '@clerk\u002Fnextjs\u002Fserver'\n\nexport async function getServerSideProps() {\n  const { userId } = await auth()\n  if (!userId) {\n    return { redirect: { destination: '\u002Fsign-in' } }\n  }\n  const user = await currentUser()\n  return { props: { user } }\n}\n```\n\n### 4. Supabase Auth to Clerk\n\n#### Step 1: Export Supabase Users\n```typescript\n\u002F\u002F scripts\u002Fexport-supabase-users.ts\nimport { createClient } from '@supabase\u002Fsupabase-js'\n\nconst supabase = createClient(\n  process.env.SUPABASE_URL!,\n  process.env.SUPABASE_SERVICE_KEY! \u002F\u002F Service key for admin access\n)\n\nasync function exportSupabaseUsers() {\n  const { data: { users }, error } = await supabase.auth.admin.listUsers()\n\n  if (error) throw error\n\n  return users\n}\n```\n\n#### Step 2: Migrate to Clerk\n```typescript\n\u002F\u002F scripts\u002Fmigrate-supabase-to-clerk.ts\nasync function migrateSupabaseUsers() {\n  const supabaseUsers = await exportSupabaseUsers()\n  const client = await clerkClient()\n\n  for (const sbUser of supabaseUsers) {\n    try {\n      await client.users.createUser({\n        externalId: sbUser.id,\n        emailAddress: sbUser.email ? [sbUser.email] : [],\n        phoneNumber: sbUser.phone ? [sbUser.phone] : [],\n        publicMetadata: {\n          migrated_from: 'supabase',\n          supabase_id: sbUser.id,\n          user_metadata: sbUser.user_metadata\n        },\n        skipPasswordRequirement: true\n      })\n    } catch (error) {\n      console.error(`Failed to migrate ${sbUser.id}:`, error)\n    }\n  }\n}\n```\n\n## Migration Strategy\n\n### Phase 1: Preparation\n```markdown\n- [ ] Audit current user base\n- [ ] Document all authentication flows\n- [ ] Plan data mapping\n- [ ] Set up Clerk development instance\n- [ ] Create migration scripts\n- [ ] Test with sample users\n```\n\n### Phase 2: Parallel Running\n```typescript\n\u002F\u002F middleware.ts - Support both auth systems during migration\nimport { clerkMiddleware } from '@clerk\u002Fnextjs\u002Fserver'\nimport { legacyAuth } from '.\u002Flegacy-auth'\n\nexport default async function middleware(request: NextRequest) {\n  \u002F\u002F Check Clerk first\n  const clerkAuth = await clerkMiddleware(request)\n  if (clerkAuth.userId) {\n    return clerkAuth\n  }\n\n  \u002F\u002F Fall back to legacy auth during migration\n  const legacySession = await legacyAuth(request)\n  if (legacySession) {\n    \u002F\u002F Log for migration tracking\n    console.log('Legacy auth used:', legacySession.userId)\n    return legacySession\n  }\n\n  return NextResponse.redirect('\u002Fsign-in')\n}\n```\n\n### Phase 3: User Migration\n```typescript\n\u002F\u002F Migrate users on first Clerk login\nexport async function POST(request: Request) {\n  const { email, legacyToken } = await request.json()\n\n  \u002F\u002F Verify with legacy system\n  const legacyUser = await verifyLegacyToken(legacyToken)\n  if (!legacyUser) {\n    return Response.json({ error: 'Invalid legacy token' }, { status: 401 })\n  }\n\n  \u002F\u002F Check if already migrated\n  const client = await clerkClient()\n  const { data: existingUsers } = await client.users.getUserList({\n    emailAddress: [email]\n  })\n\n  if (existingUsers.length > 0) {\n    return Response.json({ migrated: true, userId: existingUsers[0].id })\n  }\n\n  \u002F\u002F Create in Clerk\n  const clerkUser = await client.users.createUser({\n    emailAddress: [email],\n    firstName: legacyUser.firstName,\n    lastName: legacyUser.lastName,\n    publicMetadata: {\n      migrated_from: 'legacy',\n      legacy_id: legacyUser.id\n    }\n  })\n\n  return Response.json({ migrated: true, userId: clerkUser.id })\n}\n```\n\n### Phase 4: Cutover\n```markdown\n- [ ] Disable new registrations on legacy system\n- [ ] Migrate remaining users\n- [ ] Update DNS\u002Fredirects\n- [ ] Remove legacy auth code\n- [ ] Decommission legacy system\n```\n\n## Output\n- User migration scripts\n- Parallel running configuration\n- Phased migration plan\n- Rollback procedures\n\n## Migration Checklist\n\n- [ ] Export all users from source system\n- [ ] Transform user data to Clerk format\n- [ ] Test import with small batch\n- [ ] Plan password reset strategy\n- [ ] Configure OAuth providers in Clerk\n- [ ] Update all authentication code\n- [ ] Test all auth flows\n- [ ] Monitor migration progress\n- [ ] Handle edge cases\n\n## Error Handling\n| Error | Cause | Solution |\n|-------|-------|----------|\n| Duplicate email | User already exists | Skip or merge |\n| Invalid email format | Data quality issue | Clean before import |\n| Rate limited | Too fast import | Add delays |\n| Password migration | Can't export passwords | Force password reset |\n\n## Resources\n- [Clerk Migration Guide](https:\u002F\u002Fclerk.com\u002Fdocs\u002Fdeployments\u002Fmigrate-overview)\n- [User Import API](https:\u002F\u002Fclerk.com\u002Fdocs\u002Fusers\u002Fcreating-users)\n- [Auth0 Migration](https:\u002F\u002Fclerk.com\u002Fdocs\u002Fdeployments\u002Fmigrate-from-auth0)\n\n## Next Steps\nAfter migration, review `clerk-prod-checklist` for production readiness.\n","# Clerk Migration Deep Dive\n\n## Overview\nComprehensive guide to migrating from other authentication providers to Clerk.\n\n## Prerequisites\n- Current auth provider access\n- User data export capability\n- Clerk account and API keys\n- Migration timeline planned\n\n## Migration Sources\n\n### 1. Auth0 to Clerk\n\n#### Step 1: Export Users from Auth0\n```bash\n# Using Auth0 Management API\ncurl -X GET \"https:\u002F\u002FYOUR_DOMAIN.auth0.com\u002Fapi\u002Fv2\u002Fusers\" \\\n  -H \"Authorization: Bearer YOUR_MGMT_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  > auth0-users.json\n```\n\n#### Step 2: Transform User Data\n```typescript\n\u002F\u002F scripts\u002Ftransform-auth0-users.ts\ninterface Auth0User {\n  user_id: string\n  email: string\n  email_verified: boolean\n  name: string\n  given_name?: string\n  family_name?: string\n  picture?: string\n  created_at: string\n  last_login?: string\n}\n\ninterface ClerkImportUser {\n  external_id: string\n  email_addresses: Array\u003C{\n    email_address: string\n    verified: boolean\n  }>\n  first_name?: string\n  last_name?: string\n  image_url?: string\n  created_at: string\n  public_metadata?: Record\u003Cstring, any>\n}\n\nfunction transformAuth0ToClerk(auth0User: Auth0User): ClerkImportUser {\n  return {\n    external_id: auth0User.user_id,\n    email_addresses: [{\n      email_address: auth0User.email,\n      verified: auth0User.email_verified\n    }],\n    first_name: auth0User.given_name,\n    last_name: auth0User.family_name,\n    image_url: auth0User.picture,\n    created_at: auth0User.created_at,\n    public_metadata: {\n      migrated_from: 'auth0',\n      migrated_at: new Date().toISOString()\n    }\n  }\n}\n```\n\n#### Step 3: Import to Clerk\n```typescript\n\u002F\u002F scripts\u002Fimport-to-clerk.ts\nimport { clerkClient } from '@clerk\u002Fnextjs\u002Fserver'\n\nasync function importUsers(users: ClerkImportUser[]) {\n  const client = await clerkClient()\n  const results = { success: 0, failed: 0, errors: [] as string[] }\n\n  for (const user of users) {\n    try {\n      await client.users.createUser({\n        externalId: user.external_id,\n        emailAddress: [user.email_addresses[0].email_address],\n        firstName: user.first_name,\n        lastName: user.last_name,\n        publicMetadata: user.public_metadata,\n        skipPasswordRequirement: true \u002F\u002F User will set password on first login\n      })\n      results.success++\n    } catch (error: any) {\n      results.failed++\n      results.errors.push(`${user.external_id}: ${error.message}`)\n    }\n\n    \u002F\u002F Rate limiting\n    await new Promise(r => setTimeout(r, 100))\n  }\n\n  return results\n}\n```\n\n### 2. Firebase Auth to Clerk\n\n#### Step 1: Export from Firebase\n```typescript\n\u002F\u002F scripts\u002Fexport-firebase-users.ts\nimport * as admin from 'firebase-admin'\n\nadmin.initializeApp({\n  credential: admin.credential.cert(require('.\u002Fservice-account.json'))\n})\n\nasync function exportFirebaseUsers() {\n  const users: admin.auth.UserRecord[] = []\n  let nextPageToken: string | undefined\n\n  do {\n    const result = await admin.auth().listUsers(1000, nextPageToken)\n    users.push(...result.users)\n    nextPageToken = result.pageToken\n  } while (nextPageToken)\n\n  return users\n}\n```\n\n#### Step 2: Transform and Import\n```typescript\n\u002F\u002F scripts\u002Fmigrate-firebase-to-clerk.ts\nimport { clerkClient } from '@clerk\u002Fnextjs\u002Fserver'\n\ninterface FirebaseUser {\n  uid: string\n  email?: string\n  emailVerified: boolean\n  displayName?: string\n  photoURL?: string\n  phoneNumber?: string\n  disabled: boolean\n  metadata: {\n    creationTime: string\n    lastSignInTime: string\n  }\n  providerData: Array\u003C{\n    providerId: string\n    uid: string\n  }>\n}\n\nasync function migrateFirebaseUsers(firebaseUsers: FirebaseUser[]) {\n  const client = await clerkClient()\n\n  for (const fbUser of firebaseUsers) {\n    if (fbUser.disabled || !fbUser.email) continue\n\n    try {\n      await client.users.createUser({\n        externalId: fbUser.uid,\n        emailAddress: [fbUser.email],\n        firstName: fbUser.displayName?.split(' ')[0],\n        lastName: fbUser.displayName?.split(' ').slice(1).join(' '),\n        publicMetadata: {\n          migrated_from: 'firebase',\n          firebase_uid: fbUser.uid,\n          providers: fbUser.providerData.map(p => p.providerId)\n        },\n        skipPasswordRequirement: true\n      })\n    } catch (error) {\n      console.error(`Failed to migrate ${fbUser.uid}:`, error)\n    }\n  }\n}\n```\n\n### 3. NextAuth.js to Clerk\n\n#### Step 1: Database Migration\n```typescript\n\u002F\u002F scripts\u002Fmigrate-nextauth-db.ts\n\u002F\u002F Assuming Prisma with NextAuth schema\n\nasync function migrateNextAuthUsers() {\n  \u002F\u002F Get all users from NextAuth database\n  const nextAuthUsers = await prisma.user.findMany({\n    include: {\n      accounts: true,\n      sessions: true\n    }\n  })\n\n  const client = await clerkClient()\n\n  for (const user of nextAuthUsers) {\n    try {\n      \u002F\u002F Create user in Clerk\n      const clerkUser = await client.users.createUser({\n        externalId: user.id,\n        emailAddress: user.email ? [user.email] : [],\n        firstName: user.name?.split(' ')[0],\n        lastName: user.name?.split(' ').slice(1).join(' '),\n        publicMetadata: {\n          migrated_from: 'nextauth',\n          nextauth_id: user.id\n        },\n        skipPasswordRequirement: true\n      })\n\n      \u002F\u002F Update local database with new Clerk ID\n      await prisma.user.update({\n        where: { id: user.id },\n        data: { clerkId: clerkUser.id }\n      })\n    } catch (error) {\n      console.error(`Failed to migrate ${user.id}:`, error)\n    }\n  }\n}\n```\n\n#### Step 2: Update Application Code\n```typescript\n\u002F\u002F BEFORE: NextAuth\nimport { getSession } from 'next-auth\u002Freact'\n\nexport async function getServerSideProps(context) {\n  const session = await getSession(context)\n  if (!session) {\n    return { redirect: { destination: '\u002Flogin' } }\n  }\n  return { props: { user: session.user } }\n}\n\n\u002F\u002F AFTER: Clerk\nimport { auth } from '@clerk\u002Fnextjs\u002Fserver'\n\nexport async function getServerSideProps() {\n  const { userId } = await auth()\n  if (!userId) {\n    return { redirect: { destination: '\u002Fsign-in' } }\n  }\n  const user = await currentUser()\n  return { props: { user } }\n}\n```\n\n### 4. Supabase Auth to Clerk\n\n#### Step 1: Export Supabase Users\n```typescript\n\u002F\u002F scripts\u002Fexport-supabase-users.ts\nimport { createClient } from '@supabase\u002Fsupabase-js'\n\nconst supabase = createClient(\n  process.env.SUPABASE_URL!,\n  process.env.SUPABASE_SERVICE_KEY! \u002F\u002F Service key for admin access\n)\n\nasync function exportSupabaseUsers() {\n  const { data: { users }, error } = await supabase.auth.admin.listUsers()\n\n  if (error) throw error\n\n  return users\n}\n```\n\n#### Step 2: Migrate to Clerk\n```typescript\n\u002F\u002F scripts\u002Fmigrate-supabase-to-clerk.ts\nasync function migrateSupabaseUsers() {\n  const supabaseUsers = await exportSupabaseUsers()\n  const client = await clerkClient()\n\n  for (const sbUser of supabaseUsers) {\n    try {\n      await client.users.createUser({\n        externalId: sbUser.id,\n        emailAddress: sbUser.email ? [sbUser.email] : [],\n        phoneNumber: sbUser.phone ? [sbUser.phone] : [],\n        publicMetadata: {\n          migrated_from: 'supabase',\n          supabase_id: sbUser.id,\n          user_metadata: sbUser.user_metadata\n        },\n        skipPasswordRequirement: true\n      })\n    } catch (error) {\n      console.error(`Failed to migrate ${sbUser.id}:`, error)\n    }\n  }\n}\n```\n\n## Migration Strategy\n\n### Phase 1: Preparation\n```markdown\n- [ ] Audit current user base\n- [ ] Document all authentication flows\n- [ ] Plan data mapping\n- [ ] Set up Clerk development instance\n- [ ] Create migration scripts\n- [ ] Test with sample users\n```\n\n### Phase 2: Parallel Running\n```typescript\n\u002F\u002F middleware.ts - Support both auth systems during migration\nimport { clerkMiddleware } from '@clerk\u002Fnextjs\u002Fserver'\nimport { legacyAuth } from '.\u002Flegacy-auth'\n\nexport default async function middleware(request: NextRequest) {\n  \u002F\u002F Check Clerk first\n  const clerkAuth = await clerkMiddleware(request)\n  if (clerkAuth.userId) {\n    return clerkAuth\n  }\n\n  \u002F\u002F Fall back to legacy auth during migration\n  const legacySession = await legacyAuth(request)\n  if (legacySession) {\n    \u002F\u002F Log for migration tracking\n    console.log('Legacy auth used:', legacySession.userId)\n    return legacySession\n  }\n\n  return NextResponse.redirect('\u002Fsign-in')\n}\n```\n\n### Phase 3: User Migration\n```typescript\n\u002F\u002F Migrate users on first Clerk login\nexport async function POST(request: Request) {\n  const { email, legacyToken } = await request.json()\n\n  \u002F\u002F Verify with legacy system\n  const legacyUser = await verifyLegacyToken(legacyToken)\n  if (!legacyUser) {\n    return Response.json({ error: 'Invalid legacy token' }, { status: 401 })\n  }\n\n  \u002F\u002F Check if already migrated\n  const client = await clerkClient()\n  const { data: existingUsers } = await client.users.getUserList({\n    emailAddress: [email]\n  })\n\n  if (existingUsers.length > 0) {\n    return Response.json({ migrated: true, userId: existingUsers[0].id })\n  }\n\n  \u002F\u002F Create in Clerk\n  const clerkUser = await client.users.createUser({\n    emailAddress: [email],\n    firstName: legacyUser.firstName,\n    lastName: legacyUser.lastName,\n    publicMetadata: {\n      migrated_from: 'legacy',\n      legacy_id: legacyUser.id\n    }\n  })\n\n  return Response.json({ migrated: true, userId: clerkUser.id })\n}\n```\n\n### Phase 4: Cutover\n```markdown\n- [ ] Disable new registrations on legacy system\n- [ ] Migrate remaining users\n- [ ] Update DNS\u002Fredirects\n- [ ] Remove legacy auth code\n- [ ] Decommission legacy system\n```\n\n## Output\n- User migration scripts\n- Parallel running configuration\n- Phased migration plan\n- Rollback procedures\n\n## Migration Checklist\n\n- [ ] Export all users from source system\n- [ ] Transform user data to Clerk format\n- [ ] Test import with small batch\n- [ ] Plan password reset strategy\n- [ ] Configure OAuth providers in Clerk\n- [ ] Update all authentication code\n- [ ] Test all auth flows\n- [ ] Monitor migration progress\n- [ ] Handle edge cases\n\n## Error Handling\n| Error | Cause | Solution |\n|-------|-------|----------|\n| Duplicate email | User already exists | Skip or merge |\n| Invalid email format | Data quality issue | Clean before import |\n| Rate limited | Too fast import | Add delays |\n| Password migration | Can't export passwords | Force password reset |\n\n## Resources\n- [Clerk Migration Guide](https:\u002F\u002Fclerk.com\u002Fdocs\u002Fdeployments\u002Fmigrate-overview)\n- [User Import API](https:\u002F\u002Fclerk.com\u002Fdocs\u002Fusers\u002Fcreating-users)\n- [Auth0 Migration](https:\u002F\u002Fclerk.com\u002Fdocs\u002Fdeployments\u002Fmigrate-from-auth0)\n\n## Next Steps\nAfter migration, review `clerk-prod-checklist` for production readiness.\n",{"name":5,"author":48,"license":15,"version":49,"description":50,"allowed-tools":51},"Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Migrate from other authentication providers to Clerk.\nUse when migrating from Auth0, Firebase, Supabase Auth, NextAuth,\nor custom authentication solutions.\nTrigger with phrases like \"migrate to clerk\", \"clerk migration\",\n\"switch to clerk\", \"auth0 to clerk\", \"firebase auth to clerk\".\n","Read, Write, Edit, Bash(npm:*), Grep","main","7439377908fdee98c9bb5863391212b95453de95","tests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fclerk-pack\u002Fskills\u002Fclerk-migration-deep-dive",233,"https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust","https:\u002F\u002Fgithub.com\u002FDicklesworthstone","https:\u002F\u002Fwww.jeffreyemanuel.com\u002F","Building in NY","2026-11-15 01:54:15",{"source":8,"skillName":5,"commands":62,"prompt":72,"zipAvailable":73},[63,66,69],{"tool":64,"command":65},"npx","npx skills add Dicklesworthstone\u002Fpi_agent_rust --skill clerk-migration-deep-dive",{"tool":67,"command":68},"bunx","bunx skills add Dicklesworthstone\u002Fpi_agent_rust --skill clerk-migration-deep-dive",{"tool":70,"command":71},"pnpm","pnpm dlx skills add Dicklesworthstone\u002Fpi_agent_rust --skill clerk-migration-deep-dive","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fclerk-pack\u002Fskills\u002Fclerk-migration-deep-dive\u002FSKILL.md",true,[75,80,86],{"path":76,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":78,"sourceHtmlUrl":79},"LICENSE","许可证",1071,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fmcp-servers\u002Fdanthamanvoiss-salesportl-sales-marketing-offer-service-mapper\u002FLICENSE",{"path":81,"resourceType":82,"resourceTypeDesc":83,"sizeBytes":84,"sourceHtmlUrl":85},"SOURCE.md","REFERENCE","参考文档",502,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fmcp-servers\u002Fdanthamanvoiss-salesportl-sales-marketing-offer-service-mapper\u002FSOURCE.md",{"path":87,"resourceType":82,"resourceTypeDesc":83,"sizeBytes":88,"sourceHtmlUrl":89},"TRUST.auto.yaml",2217,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fmcp-servers\u002Fdanthamanvoiss-salesportl-sales-marketing-offer-service-mapper\u002FTRUST.auto.yaml",[91,125,160,183,209,236],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":95,"licenseFileUrl":96,"sourceHtmlUrl":97,"categories":98,"keywords":104,"publishedAt":124},"01M6FCR7G5A005P364Z6ZWCJDP","theme-factory","Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors\u002Ffonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fcreative-design\u002Ftheme-factory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fcreative-design\u002Ftheme-factory\u002FSKILL.md",[99],{"categoryNo":100,"categoryName":101,"taxonomyType":102,"taxonomyTypeDesc":103},"01JBSEEDCAT000000000000015","视觉设计","SCENARIO","使用场景",[105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],"theme factory","factory","theme","docs","toolkit","generate","artifacts","SET","fly","slides","landing","html","styling","artifact","pages","themes","with","you","fonts","2026-11-11 15:11:14",{"skillNo":126,"name":127,"nameZh":6,"description":128,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":95,"licenseFileUrl":129,"sourceHtmlUrl":130,"categories":131,"keywords":135,"publishedAt":43},"01M6FEGPPK0ZTKCCM0R3E3KS33","web-artifacts-builder","Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn\u002Fui). Use for complex artifacts requiring state management, routing, or shadcn\u002Fui components - not for simple single-file HTML\u002FJSX artifacts.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Futilities\u002Fweb-artifacts-builder\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Futilities\u002Fweb-artifacts-builder\u002FSKILL.md",[132],{"categoryNo":133,"categoryName":134,"taxonomyType":102,"taxonomyTypeDesc":103},"01JBSEEDCAT000000000000009","前端开发",[136,137,111,138,139,140,141,142,143,144,145,146,147,148,149,150,151,152,24,116,153,154,155,156,157,158,159],"web artifacts builder","web","artifacts builder","builder","frontend","css","components","react","component","routing","state management","state","shadcn","file","ui","Tools","Tailwind","single-file","simple","ui components","multi","for","jsx","suite",{"skillNo":161,"name":162,"nameZh":6,"description":163,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":95,"licenseFileUrl":164,"sourceHtmlUrl":165,"categories":166,"keywords":171,"publishedAt":43},"01M6FEE9VTK1W4GY21AKREJXRG","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fsecurity\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fsecurity\u002Fwebapp-testing\u002FSKILL.md",[167,170],{"categoryNo":168,"categoryName":169,"taxonomyType":102,"taxonomyTypeDesc":103},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":133,"categoryName":134,"taxonomyType":102,"taxonomyTypeDesc":103},[172,173,174,140,175,176,137,177,109,178,150,179,180,181,182,121,157],"testing","webapp testing","webapp","screenshots","playwright","debugging","browser","logs","applications","behavior","local",{"skillNo":184,"name":185,"nameZh":6,"description":186,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":187,"sourceHtmlUrl":188,"categories":189,"keywords":190,"publishedAt":43},"01M6FE20F7ZTQBFWKF4MPJ2SBX","neuropixels-analysis","Neuropixels neural recording analysis. Load SpikeGLX\u002FOpenEphys data, preprocess, motion correction, Kilosort4 spike sorting, quality metrics, Allen\u002FIBL curation, AI-assisted visual analysis, for Neuropixels 1.0\u002F2.0 extracellular electrophysiology. Use when working with neural recordings, spike sorting, extracellular electrophysiology, or when the user mentions Neuropixels, SpikeGLX, Open Ephys, Kilosort, quality metrics, or unit curation.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Fneuropixels-analysis\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Fneuropixels-analysis\u002FSKILL.md",[],[191,192,193,194,195,196,197,198,24,199,200,201,202,203,204,205,121,206,207,208,157,26],"analysis","neuropixels analysis","spike","metrics","data","open","quality","user","recordings","Neural","motion","visual","quality metrics","unit","sorting","curation","recording","load",{"skillNo":210,"name":211,"nameZh":6,"description":212,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":95,"licenseFileUrl":213,"sourceHtmlUrl":214,"categories":215,"keywords":219,"publishedAt":43},"01M6FDP0PDK6F1GGX395C7625Z","skill-creator","Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fskill-creator\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fskill-creator\u002FSKILL.md",[216],{"categoryNo":217,"categoryName":218,"taxonomyType":102,"taxonomyTypeDesc":103},"01JBSEEDCAT000000000000023","Skill与智能体开发",[220,221,222,223,224,225,226,227,228,229,230,231,232,233,121,157,234,26,235],"skill creator","creator","workflows","create","update","capabilities","knowledge","tool","integrations","specialized","guide","new skill","existing skill","users","Existing","new",{"skillNo":237,"name":238,"nameZh":6,"description":239,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":240,"sourceHtmlUrl":241,"categories":242,"keywords":244,"publishedAt":43},"01M6FDM8Y7VK7NYG9SM7QPA3PW","notebooklm","Use this skill to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini. Browser automation, library management, persistent auth. Drastically reduced hallucinations through document-only responses.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fnotebooklm\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fnotebooklm\u002FSKILL.md",[243],{"categoryNo":217,"categoryName":218,"taxonomyType":102,"taxonomyTypeDesc":103},[238,245,246,247,248,31,249,178,250,251,24,252,253,254,255,157,256],"google","browser automation","gemini","automation","code","library","management","only","document","query","Citation","source"]