Clerk Skills
Skills to help AI coding agents work more effectively with Clerk.
Skills follow the Agent Skills format.
Install
Agent Skills
npx skills add clerk/skills
Codex
codex plugin marketplace add clerk/skills
After 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/clerk
Skills
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-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 |
clerk-expo | Expo / React Native | Native components, custom flows, SMS OTP, OAuth |
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_xxx
2. 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 |
| "Add phone SMS auth to my Expo app" | clerk-expo |
| "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-chrome-extension-patterns/
│ ├── features/
│ │ ├── clerk-orgs/
│ │ ├── clerk-billing/
│ │ ├── clerk-webhooks/
│ │ └── clerk-testing/
│ └── mobile/
│ ├── clerk-swift/
│ ├── clerk-android/
│ └── clerk-expo/
└── README.md
Resources
Request a Skill
Don't see what you need? Request a skill.
License
MIT