skills
AI Skills to enhance working with Clerk
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/clerk/skills with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/clerk/skills'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/clerk--skills)HTML
<a href="/listings/clerk--skills"><img src="/api/listings/clerk--skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
The `clerk` plugin bundles every skill plus the [Clerk MCP server](https://mcp.clerk.com/mcp). `npx skills` installs the skills alone, into any agent.
Agent Skills
npx skills add clerk/skills
Claude Code
/plugin marketplace add clerk/skills /plugin install clerk@clerk-skills
To get updates automatically, open `/plugin`, go to **Marketplaces**, select `clerk-skills`, and enable auto-update.
Codex
codex plugin marketplace add clerk/skills codex plugin add clerk@clerk
`clerk` 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
cursor-agent plugin marketplace add https://github.com/clerk/skills
Then install `clerk` from `/plugin`, or from **Customize** in the editor.
GitHub Copilot CLI
copilot plugin marketplace add clerk/skills copilot plugin install clerk@clerk-skills
`clerk` 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.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 24 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- {
- "name": "clerk-skills",
- "owner": {
- "name": "Clerk",
- "email": "ai@clerk.dev"
- },
- "metadata": {
- "description": "Official Clerk skills for AI coding agents",
- "version": "1.0.0"
- },
- "plugins": [
- {
- "name": "clerk",
- "source": "./",
- "description": "Add authentication and user management with Clerk. Skills for setup, framework patterns, organizations, billing, webhooks, and testing, plus the Clerk MCP server."
- }
- ],
- "renames": {
- "core": "clerk",
- "frameworks": "clerk",
- "features": "clerk",
- "mobile": "clerk"
- }
- }
README.md · README · 239 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <p align="center">
- <a href="https://clerk.com?utm_source=github&utm_medium=clerk_skills" target="_blank" rel="noopener noreferrer">
- <img src="./assets/logo-pixel.svg" height="84">
- </a>
- <br />
- </p>
- <div align="center">
- <h1>
- Clerk Skills
- </h1>
- <a href="https://clerk.com/docs">
- <img alt="Documentation" src="https://img.shields.io/badge/documentation-clerk-green.svg" />
- </a>
- <a href="https://clerk.com/discord">
- <img alt="Discord" src="https://img.shields.io/discord/856971667393609759?color=7389D8&label&logo=discord&logoColor=ffffff" />
- </a>
- <a href="https://x.com/clerk">
- <img alt="Follow on X" src="https://img.shields.io/twitter/url.svg?label=%40clerk&style=social&url=https%3A%2F%2Fx.com%2Fclerk" />
- </a>
- <br />
- <br />
- <p>
- <strong>
- Skills to help AI coding agents work more effectively with Clerk.
- </strong>
- </p>
- </div>
- ---
- Skills follow the [Agent Skills](https://agentskills.io/) format.
- ## Install
- The `clerk` plugin bundles every skill plus the [Clerk MCP server](#clerk-mcp-server). `npx skills` installs the skills alone, into any agent.
- ### Agent Skills
- ```bash
- npx skills add clerk/skills
- ```
- ### Claude Code
- ```bash
- /plugin marketplace add clerk/skills
- /plugin install clerk@clerk-skills
- ```
- To get updates automatically, open `/plugin`, go to **Marketplaces**, select `clerk-skills`, and enable auto-update.
- ### Codex
- ```bash
- codex plugin marketplace add clerk/skills
- codex plugin add clerk@clerk
- ```
- `clerk` 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
- ```bash
- cursor-agent plugin marketplace add https://github.com/clerk/skills
- ```
- Then install `clerk` from `/plugin`, or from **Customize** in the editor.
- ### Antigravity
- ```bash
- agy plugin install https://github.com/clerk/skills
- ```
- To sign in to the Clerk MCP server, open `/plugin`, expand `clerk` under **Installed**, and choose **Sign in**.
- ### GitHub Copilot CLI
- ```bash
- copilot plugin marketplace add clerk/skills
- copilot plugin install clerk@clerk-skills
- ```
- `clerk` 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.
- ## Clerk MCP Server
- 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-saas` and `organizations`.
- ### Connect
- 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](https://clerk.com/docs/guides/ai/mcp/clerk-mcp-server) for setup steps in popular agents.
- ### Permissions
- 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](https://clerk.com/docs/guides/ai/mcp/clerk-mcp-server#what-does-the-mcp-server-send-to-clerk-about-tool-calls).
- ### Example prompts
- - "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: true` to the public metadata for `alex@example.com` in development"
- - "Check which DNS records I need for production"
- - "Show me how to set up B2B SaaS with Clerk Organizations"
- ## 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-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 |
- ### 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, 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 |
- ## Quick Start
- ### 1. Ask Your Agent to Add Clerk
- After installing Clerk Skills, ask your coding agent to add Clerk authentication
- to your app. The [`clerk-setup`](skills/clerk-setup/SKILL.md) 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](skills/clerk-setup/SKILL.md#step-1c-accountless-development-keys)
- for how temporary keys and later account claiming work.
- ### 2. Example Requests
- | 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` |
- ## Repository Structure
- ```
- 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
- ```
- ## Contributing
- This repo uses [pnpm](https://pnpm.io). If you've enabled Corepack, run `corepack disable pnpm` first; Corepack can't run pnpm 12.
- [Install pnpm](https://pnpm.io/installation), then run:
- ```bash
- pnpm install
- pnpm test # test the checkers
- pnpm run check # validate the skills
- ```
- ## Resources
- - [Clerk Docs](https://clerk.com/docs)
- - [Dashboard](https://dashboard.clerk.com)
- - [Discord](https://clerk.com/discord)
- ## Request a Skill
- Don't see what you need? [Request a skill](https://github.com/clerk/skills/issues/new?template=skill-request.md).
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.