
clerk / skills
★ 54A skill package that teaches your agent 19 capabilities — every one documented and browsable below, no GitHub required · by clerk.
Each skill below is one capability this package teaches your agent. Install the whole package, or open a skill to install just that one.
Intelligent router that directs authentication tasks to specialized Clerk skills based on your framework and use case. Routes to eight specialized skills covering setup, custom UI, Next.js patterns, organizations, webhooks, testing, native iOS/Android, and backend API Detects Clerk SDK version (Core 2 LTS vs. current) from package.json to apply correct patterns and APIs Covers web frameworks (Next.js, React, Expo, React Router, TanStack Start) and native platforms (Swift/iOS, Kotlin/Android)...
1 file — installable on its own
Implement Clerk authentication for native Android apps using Kotlin and
4 files — installable on its own
Astro patterns with Clerk — middleware, SSR pages, island components,
20 files — installable on its own
Clerk Backend REST API explorer and executor. Browse tags, inspect endpoint schemas, and execute authenticated requests. Use when listing users, managing…
9 files — installable on its own
Clerk Billing for subscription management - render Clerk's PricingTable
8 files — installable on its own
Chrome Extension auth with @clerk/chrome-extension -- popup/sidepanel
14 files — installable on its own
Build custom authentication flows and visually brand Clerk components with hooks and appearance styling. Provides useSignIn and useSignUp hooks for building custom sign-in/sign-up UI; API differs between Core 2 and current SDK versions Appearance customization via variables (colors, typography, borders), options (logo, social button layout), and pre-built themes (dark, neobrutalism, shadcn, simple) shadcn theme automatically matches shadcn/ui projects when components.json is present; theme...
8 files — installable on its own
Expo / React Native patterns with Clerk — SecureStore token cache, OAuth
20 files — installable on its own
Advanced Next.js patterns for authentication, middleware, Server Actions, and user-scoped caching with Clerk. Distinguishes server-side await auth() from client-side useAuth() hook; mixing them is a common breaking mistake Covers middleware strategies (public-first vs protected-first), API route protection, and proper HTTP status codes (401 vs 403) Includes user-scoped caching patterns with unstable_cache and protecting Server Actions from unauthorized mutations Provides Core 2 compatibility...
17 files — installable on its own
Nuxt 3 auth patterns with @clerk/nuxt - middleware, composables, server
13 files — installable on its own
Multi-tenant B2B SaaS with organization switching, role-based access control, and enterprise SSO. Supports dynamic org-based routing via URL slugs, role-based access checks ( org:admin , org:member ), and custom role creation through the dashboard Includes OrganizationSwitcher component for user-facing org selection and <Show> conditional rendering for role-gated UI Provides server-side organization context via auth() helper with membership verification and permission checks Enables...
8 files — installable on its own
React SPA auth patterns with @clerk/react for Vite/CRA - ClerkProvider
17 files — installable on its own
React Router v7 patterns with Clerk — rootAuthLoader, getAuth in loaders,
18 files — installable on its own
Framework-agnostic Clerk authentication setup following official quickstart guides. Detects framework from package.json dependencies and fetches the corresponding Clerk quickstart documentation (supports Next.js, Remix, Astro, Nuxt, React Router, TanStack Start, React SPA, Vue, Express, Fastify, Expo, Chrome Extension, Android, iOS, and Vanilla JavaScript) Handles environment variable setup, provider configuration, and middleware/proxy file creation with version-specific guidance for Core 2...
3 files — installable on its own
Native Swift/iOS authentication using ClerkKit with prebuilt or custom auth flows. Supports two implementation modes: prebuilt AuthView components or fully custom native flows, selected based on project requirements Requires direct wiring of a valid Clerk publishable key in app configuration; does not use plist or environment file indirection by default Mandatory /v1/environment call after package install to determine feature availability (for example Apple Sign In support) based on...
4 files — installable on its own
TanStack React Start auth patterns with @clerk/tanstack-react-start
19 files — installable on its own
E2E testing utilities for Clerk authentication flows in Playwright and Cypress. Supports both Playwright and Cypress frameworks with framework-specific setup patterns (globalSetup for Playwright, custom commands for Cypress) Provides clerkSetup() and setupClerkTestingToken() utilities to initialize test environments and bypass bot detection Includes storageState persistence to reuse authenticated sessions across tests, reducing test execution time Requires test API keys ( pk_test_* ,...
1 file — installable on its own
Vue 3 patterns with Clerk — composables (useAuth, useUser,
16 files — installable on its own
Real-time event webhooks for syncing Clerk user, organization, and session data to external systems. Supports 40+ event types across users, organizations, sessions, roles, permissions, invitations, and communications Includes built-in webhook verification via verifyWebhook() and automatic retry logic through Svix (up to 3 days) Best suited for background tasks like database syncing, notifications, and integrations; not for synchronous flows requiring immediate data access Requires public,...
5 files — installable on its own
Skills follow the Agent Skills format.
Install
Agent Skills
npx skills add clerk/skillsCodex
codex plugin marketplace add clerk/skillsAfter adding the marketplace, restart Codex, open /plugins, select
Clerk Skills, install and enable clerk-skills, then start a new thread.
Manual (Claude Code)
git clone https://github.com/clerk/skills ~/.claude/skills/clerkSkills
Core
| Skill | Purpose | When to Use |
|---|---|---|
/clerk | Router - Routes to the right skill | Always start here |
clerk-cli | Clerk CLI operations | Users, orgs, apps, env keys, deploy checks |
clerk-setup | Add Clerk to any framework | New projects, framework setup |
clerk-custom-ui | Custom sign-in/up and appearance | Building custom forms, styling |
clerk-backend-api | Backend REST API explorer | Browsing or calling API endpoints |
Framework Patterns
| Skill | Framework | Patterns |
|---|---|---|
clerk-nextjs-patterns | Next.js | Middleware, Server Actions, caching |
clerk-react-patterns | React | Hooks, auth guards, protected routes |
clerk-react-router-patterns | React Router | Loaders, actions, route protection |
clerk-vue-patterns | Vue | Composables, Pinia integration |
clerk-nuxt-patterns | Nuxt | Server middleware, SSR auth |
clerk-astro-patterns | Astro | SSR auth, island components |
clerk-tanstack-patterns | TanStack Start | Server functions, route protection |
clerk-expo-patterns | Expo | Secure storage, deep linking |
clerk-chrome-extension-patterns | Chrome Extension | Background scripts, popup auth |
Features
| Skill | Purpose | When to Use |
|---|---|---|
clerk-orgs | Multi-tenant B2B organizations | Team workspaces, RBAC |
clerk-billing | Subscription billing and feature gating | Pricing tables, plans, per-seat, entitlements |
clerk-webhooks | Real-time events and data syncing | Database sync, notifications |
clerk-testing | E2E testing for auth flows | Playwright/Cypress tests |
Native Mobile
| Skill | Platform | Patterns |
|---|---|---|
clerk-swift | iOS | ClerkKit, SwiftUI, Apple Sign-In |
clerk-android | Android | Kotlin, Jetpack Compose |
Quick Start
1. Set Up API Keys
Get your keys from the Clerk Dashboard and add them to .env:
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_xxx
CLERK_SECRET_KEY=sk_test_xxx2. Ask Your Agent
| You Say | Skill Used |
|---|---|
| "List Clerk users" | clerk-cli |
| "Add Clerk auth to my Next.js app" | clerk-setup |
| "Use Server Actions with Clerk" | clerk-nextjs-patterns |
| "Add Clerk to my Vue app" | clerk-vue-patterns |
| "Add Clerk to my Nuxt app" | clerk-nuxt-patterns |
| "Add auth to my Expo app" | clerk-expo-patterns |
| "Add Clerk to my Astro site" | clerk-astro-patterns |
| "Build custom sign-in form" | clerk-custom-ui |
| "Sync users to Prisma via webhooks" | clerk-webhooks |
| "Add Playwright tests for auth" | clerk-testing |
| "Set up organizations for my B2B app" | clerk-orgs |
| "Add subscription billing with pricing table" | clerk-billing |
| "Gate features by plan" | clerk-billing |
| "Add Clerk auth to my iOS app" | clerk-swift |
| "Add Clerk auth to my Android app" | clerk-android |
Repository Structure
clerk-skills/
├── .agents/
│ └── plugins/
│ └── marketplace.json
├── .codex-plugin/
│ └── plugin.json
├── .claude-plugin/
│ └── marketplace.json
├── skills/
│ ├── core/
│ │ ├── clerk/ # Router skill
│ │ ├── clerk-cli/ # CLI operations
│ │ ├── clerk-setup/ # Framework setup
│ │ ├── clerk-custom-ui/ # Component customization
│ │ └── clerk-backend-api/ # REST API explorer
│ ├── frameworks/
│ │ ├── clerk-nextjs-patterns/
│ │ ├── clerk-react-patterns/
│ │ ├── clerk-react-router-patterns/
│ │ ├── clerk-vue-patterns/
│ │ ├── clerk-nuxt-patterns/
│ │ ├── clerk-astro-patterns/
│ │ ├── clerk-tanstack-patterns/
│ │ ├── clerk-expo-patterns/
│ │ └── clerk-chrome-extension-patterns/
│ ├── features/
│ │ ├── clerk-orgs/
│ │ ├── clerk-billing/
│ │ ├── clerk-webhooks/
│ │ └── clerk-testing/
│ └── mobile/
│ ├── clerk-swift/
│ └── clerk-android/
└── README.mdResources
Request a Skill
Don't see what you need? Request a skill.
License
MIT
Install the whole package (19 skills):
npx skills add https://github.com/clerk/skillsOr install a single skill:
npx skills add https://github.com/clerk/skills --skill <name>Pick the skill name from the Skills tab — each entry there installs independently.