Skills follow the Agent Skills format.
The clerk plugin bundles every skill plus the Clerk MCP server. npx skills installs the skills alone, into any agent.
npx skills add clerk/skills/plugin marketplace add clerk/skills
/plugin install clerk@clerk-skillsTo get updates automatically, open /plugin, go to Marketplaces, select clerk-skills, and enable auto-update.
codex plugin marketplace add clerk/skills
codex plugin add clerk@clerkclerk replaces the earlier clerk-skills@clerk plugin, which no longer updates. To switch, run codex plugin remove clerk-skills@clerk, then add clerk@clerk.
cursor-agent plugin marketplace add https://github.com/clerk/skillsThen install clerk from /plugin, or from Customize in the editor.
agy plugin install https://github.com/clerk/skillsTo sign in to the Clerk MCP server, open /plugin, expand clerk under Installed, and choose Sign in.
copilot plugin marketplace add clerk/skills
copilot plugin install clerk@clerk-skillsclerk replaces the earlier core, frameworks, features, and mobile plugins. Copilot moves those installs to clerk@clerk-skills but leaves it disabled, so run copilot plugin enable clerk@clerk-skills once.
The Clerk MCP server lets AI agents work with your Clerk account. Clerk hosts it, so there's no server to run.
- Account tools: create and configure applications, list, create, and update users, list organizations and their members, check domains and DNS records, and set up production instances.
- SDK snippet tools: get ready-to-use code for Clerk features, or bundles such as
b2b-saasandorganizations.
Add https://mcp.clerk.com/mcp to your agent as a streamable HTTP server, then sign in with your Clerk Dashboard account when prompted. The clerk plugin above does this for you.
See the Clerk MCP server docs for setup steps in popular agents.
The server acts as you, so it can only do what your workspace role allows. It never returns secret keys, and tools that make changes are flagged so your agent can ask before running them.
For product analytics, the MCP server sends Clerk an event for each tool call. It records the tool name, whether the call succeeded, your Clerk user ID, your AI client, and, when the tool takes them, the application ID and whether the call was a dry run. It doesn't include the tool's other inputs or its results. See what data Clerk receives about tool calls.
- "Which Clerk applications do I have?"
- "List the five most recent sign-ups"
- "Show the admins of the Example Team Organization in my production instance"
- "Add
onboarding_complete: trueto the public metadata foralex@example.comin development" - "Check which DNS records I need for production"
- "Show me how to set up B2B SaaS with Clerk Organizations"
| 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-migrate |
Migrate users into Clerk | Importing users from another auth provider, dev → prod |
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 |
| 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 |
| 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 |
| Skill | Platform | Patterns |
|---|---|---|
clerk-swift |
iOS, macOS | ClerkKitUI views, custom ClerkKit flows, Sign in with Apple |
clerk-android |
Android | Kotlin, Jetpack Compose |
clerk-expo |
Expo / React Native | Native components, custom flows, SMS OTP, OAuth |
After installing Clerk Skills, ask your coding agent to add Clerk authentication
to your app. The clerk-setup skill sets up
Clerk in an existing project, scaffolds a new app in an empty directory, and can
link an existing Clerk application instead of creating a new one.
For a new project on a supported framework, clerk init can start without a
Clerk account or browser login. See Accountless development keys
for how temporary keys and later account claiming work.
| You Say | Skill Used |
|---|---|
| "List Clerk users" | clerk-cli |
| "Add Clerk auth to my Next.js app" | clerk-setup |
| "Migrate my users from Auth0 to Clerk" | clerk-migrate |
| "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-setup |
| "Add a custom sign-in screen to my SwiftUI app" | clerk-swift |
| "Add Clerk auth to my Android app" | clerk-android |
clerk-skills/ # the repo root is the plugin root
├── skills/ # one folder per skill, flat
│ ├── clerk/ # Router skill
│ ├── clerk-setup/
│ ├── clerk-nextjs-patterns/
│ └── ...
├── plugin.json # Agent Plugins 1.0.0 manifest
├── mcp.json # Agent Plugins MCP config
├── .mcp.json # Claude Code and older Codex MCP config
├── .claude-plugin/ # plugin.json + marketplace.json
├── .cursor-plugin/ # plugin.json + marketplace.json
├── .codex-plugin/plugin.json
├── .antigravity-plugin/plugin.json # Antigravity manifest
├── mcp_config.json # Antigravity MCP config
├── .agents/plugins/marketplace.json # Codex marketplace
├── scripts/ # CI checkers, run with pnpm run check
└── README.md
This repo uses pnpm. If you've enabled Corepack, run corepack disable pnpm first; Corepack can't run pnpm 12.
Install pnpm, then run:
pnpm install
pnpm test # test the checkers
pnpm run check # validate the skillsDon't see what you need? Request a skill.
MIT