clerk avatar
22
clerk

This skill enables integration with Clerk authentication across various platforms, including web, iOS, Android, and backend APIs. It offers capabilities for adding Clerk to projects, customizing sign-in/up flows, implementing advanced Next.js patterns, managing organizations, handling webhooks, and testing. Designed for developers working on multi-platform authentication solutions, it provides specific tools and patterns tailored to different SDK versions and project needs.

npx skills add https://github.com/clerk/skills --skill clerk

Clerk Skills Router

Version Detection

Check package.json to determine the Clerk SDK version. This determines which patterns to use: Package Core 2 (LTS until Jan 2027) Current @clerk/nextjs v5–v6 v7+ @clerk/react or @clerk/clerk-react v5–v6 v7+ @clerk/expo or @clerk/clerk-expo v1–v2 v3+ @clerk/react-router v1–v2 v3+ @clerk/tanstack-react-start < v0.26.0 v0.26.0+ Default to current if the version is unclear or the project is new. Core 2 packages use @clerk/clerk-react and @clerk/clerk-expo (with clerk- prefix); current packages use @clerk/react and @clerk/expo. All skills are written for the current SDK. When something differs in Core 2, it's noted inline with > **Core 2 ONLY (skip if current SDK):** callouts. The exception is clerk-custom-ui, which has separate core-2/ and core-3/ directories for custom flow hooks since those APIs are entirely different between versions.

By Task

Adding Clerk to your project → Use clerk-setup

  • Framework detection and quickstart
  • Environment setup, API keys, Keyless flow
  • Migration from other auth providers Custom sign-in/sign-up UI → Use clerk-custom-ui
  • Custom authentication flows with useSignIn / useSignUp hooks
  • Appearance and styling (themes, colors, layout)
  • <Show> component for conditional rendering Advanced Next.js patterns → Use clerk-nextjs-patterns
  • Server vs Client auth APIs
  • Middleware strategies
  • Server Actions, caching
  • API route protection B2B / Organizations → Use clerk-orgs
  • Multi-tenant apps
  • Organization slugs in URLs
  • Roles, permissions, RBAC
  • Member management Webhooks → Use clerk-webhooks
  • Real-time events
  • Data syncing
  • Notifications & integrations E2E Testing → Use clerk-testing
  • Playwright/Cypress setup
  • Auth flow testing
  • Test utilities Swift / native iOS auth → Use clerk-swift
  • Native iOS Swift and SwiftUI projects
  • ClerkKit and ClerkKitUI implementation guidance
  • Source-driven patterns from clerk-ios Android / native mobile auth → Use clerk-android
  • Native Android Kotlin and Jetpack Compose projects
  • clerk-android-api and clerk-android-ui implementation guidance
  • Source-driven patterns from clerk-android
  • Do not use for Expo or React Native projects Backend REST API → Use clerk-backend-api
  • Browse API tags and endpoints
  • Inspect endpoint schemas
  • Execute API requests with scope enforcement

Quick Navigation

If you know your task, you can directly access:

  • /clerk-setup - Framework setup
  • /clerk-custom-ui - Custom flows & appearance
  • /clerk-nextjs-patterns - Next.js patterns
  • /clerk-orgs - Organizations
  • /clerk-webhooks - Webhooks
  • /clerk-testing - Testing
  • /clerk-swift - Swift/native iOS
  • /clerk-android - Native Android
  • /clerk-backend-api - Backend REST API Or describe what you need and I'll recommend the right one.

GitHub Owner

Owner: clerk

GitHub Links

SKILL.md

name: clerk description: Clerk authentication router. Use when user asks about adding authentication, setting up Clerk, custom sign-in flows, Swift or native iOS auth, native Android auth, Next.js patterns, organizations, syncing users, or testing. Automatically routes to the specific skill based on their task.

Clerk Skills Router

Version Detection

Check package.json to determine the Clerk SDK version. This determines which patterns to use:

PackageCore 2 (LTS until Jan 2027)Current
@clerk/nextjsv5–v6v7+
@clerk/react or @clerk/clerk-reactv5–v6v7+
@clerk/expo or @clerk/clerk-expov1–v2v3+
@clerk/react-routerv1–v2v3+
@clerk/tanstack-react-start< v0.26.0v0.26.0+
Default to current if the version is unclear or the project is new. Core 2 packages use @clerk/clerk-react and @clerk/clerk-expo (with clerk- prefix); current packages use @clerk/react and @clerk/expo.
All skills are written for the current SDK. When something differs in Core 2, it's noted inline with > **Core 2 ONLY (skip if current SDK):** callouts. The exception is clerk-custom-ui, which has separate core-2/ and core-3/ directories for custom flow hooks since those APIs are entirely different between versions.

By Task

Adding Clerk to your project → Use clerk-setup

  • Framework detection and quickstart
  • Environment setup, API keys, Keyless flow
  • Migration from other auth providers Custom sign-in/sign-up UI → Use clerk-custom-ui
  • Custom authentication flows with useSignIn / useSignUp hooks
  • Appearance and styling (themes, colors, layout)
  • <Show> component for conditional rendering Advanced Next.js patterns → Use clerk-nextjs-patterns
  • Server vs Client auth APIs
  • Middleware strategies
  • Server Actions, caching
  • API route protection B2B / Organizations → Use clerk-orgs
  • Multi-tenant apps
  • Organization slugs in URLs
  • Roles, permissions, RBAC
  • Member management Webhooks → Use clerk-webhooks
  • Real-time events
  • Data syncing
  • Notifications & integrations E2E Testing → Use clerk-testing
  • Playwright/Cypress setup
  • Auth flow testing
  • Test utilities Swift / native iOS auth → Use clerk-swift
  • Native iOS Swift and SwiftUI projects
  • ClerkKit and ClerkKitUI implementation guidance
  • Source-driven patterns from clerk-ios Android / native mobile auth → Use clerk-android
  • Native Android Kotlin and Jetpack Compose projects
  • clerk-android-api and clerk-android-ui implementation guidance
  • Source-driven patterns from clerk-android
  • Do not use for Expo or React Native projects Backend REST API → Use clerk-backend-api
  • Browse API tags and endpoints
  • Inspect endpoint schemas
  • Execute API requests with scope enforcement

Quick Navigation

If you know your task, you can directly access:

  • /clerk-setup - Framework setup
  • /clerk-custom-ui - Custom flows & appearance
  • /clerk-nextjs-patterns - Next.js patterns
  • /clerk-orgs - Organizations
  • /clerk-webhooks - Webhooks
  • /clerk-testing - Testing
  • /clerk-swift - Swift/native iOS
  • /clerk-android - Native Android
  • /clerk-backend-api - Backend REST API Or describe what you need and I'll recommend the right one.

More skills

A
Swiftui Expert Skill

avdlee

C
React Native Best Practices

callstackincubator

R
Resend

resend