Skip to content
Back to search

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/clerk--skills/badge.svg)](/listings/clerk--skills)

HTML

<a href="/listings/clerk--skills"><img src="/api/listings/clerk--skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

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.

  1. {
  2. "name": "clerk-skills",
  3. "owner": {
  4. "name": "Clerk",
  5. "email": "ai@clerk.dev"
  6. },
  7. "metadata": {
  8. "description": "Official Clerk skills for AI coding agents",
  9. "version": "1.0.0"
  10. },
  11. "plugins": [
  12. {
  13. "name": "clerk",
  14. "source": "./",
  15. "description": "Add authentication and user management with Clerk. Skills for setup, framework patterns, organizations, billing, webhooks, and testing, plus the Clerk MCP server."
  16. }
  17. ],
  18. "renames": {
  19. "core": "clerk",
  20. "frameworks": "clerk",
  21. "features": "clerk",
  22. "mobile": "clerk"
  23. }
  24. }
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.

  1. <p align="center">
  2. <a href="https://clerk.com?utm_source=github&utm_medium=clerk_skills" target="_blank" rel="noopener noreferrer">
  3. <img src="./assets/logo-pixel.svg" height="84">
  4. </a>
  5. <br />
  6. </p>
  7. <div align="center">
  8. <h1>
  9. Clerk Skills
  10. </h1>
  11. <a href="https://clerk.com/docs">
  12. <img alt="Documentation" src="https://img.shields.io/badge/documentation-clerk-green.svg" />
  13. </a>
  14. <a href="https://clerk.com/discord">
  15. <img alt="Discord" src="https://img.shields.io/discord/856971667393609759?color=7389D8&label&logo=discord&logoColor=ffffff" />
  16. </a>
  17. <a href="https://x.com/clerk">
  18. <img alt="Follow on X" src="https://img.shields.io/twitter/url.svg?label=%40clerk&style=social&url=https%3A%2F%2Fx.com%2Fclerk" />
  19. </a>
  20. <br />
  21. <br />
  22. <p>
  23. <strong>
  24. Skills to help AI coding agents work more effectively with Clerk.
  25. </strong>
  26. </p>
  27. </div>
  28. ---
  29. Skills follow the [Agent Skills](https://agentskills.io/) format.
  30. ## Install
  31. The `clerk` plugin bundles every skill plus the [Clerk MCP server](#clerk-mcp-server). `npx skills` installs the skills alone, into any agent.
  32. ### Agent Skills
  33. ```bash
  34. npx skills add clerk/skills
  35. ```
  36. ### Claude Code
  37. ```bash
  38. /plugin marketplace add clerk/skills
  39. /plugin install clerk@clerk-skills
  40. ```
  41. To get updates automatically, open `/plugin`, go to **Marketplaces**, select `clerk-skills`, and enable auto-update.
  42. ### Codex
  43. ```bash
  44. codex plugin marketplace add clerk/skills
  45. codex plugin add clerk@clerk
  46. ```
  47. `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`.
  48. ### Cursor
  49. ```bash
  50. cursor-agent plugin marketplace add https://github.com/clerk/skills
  51. ```
  52. Then install `clerk` from `/plugin`, or from **Customize** in the editor.
  53. ### Antigravity
  54. ```bash
  55. agy plugin install https://github.com/clerk/skills
  56. ```
  57. To sign in to the Clerk MCP server, open `/plugin`, expand `clerk` under **Installed**, and choose **Sign in**.
  58. ### GitHub Copilot CLI
  59. ```bash
  60. copilot plugin marketplace add clerk/skills
  61. copilot plugin install clerk@clerk-skills
  62. ```
  63. `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.
  64. ## Clerk MCP Server
  65. The Clerk MCP server lets AI agents work with your Clerk account. Clerk hosts it, so there's no server to run.
  66. - **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.
  67. - **SDK snippet tools:** get ready-to-use code for Clerk features, or bundles such as `b2b-saas` and `organizations`.
  68. ### Connect
  69. 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.
  70. See the [Clerk MCP server docs](https://clerk.com/docs/guides/ai/mcp/clerk-mcp-server) for setup steps in popular agents.
  71. ### Permissions
  72. 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.
  73. 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).
  74. ### Example prompts
  75. - "Which Clerk applications do I have?"
  76. - "List the five most recent sign-ups"
  77. - "Show the admins of the Example Team Organization in my production instance"
  78. - "Add `onboarding_complete: true` to the public metadata for `alex@example.com` in development"
  79. - "Check which DNS records I need for production"
  80. - "Show me how to set up B2B SaaS with Clerk Organizations"
  81. ## Skills
  82. ### Core
  83. | Skill | Purpose | When to Use |
  84. |-------|---------|-------------|
  85. | `/clerk` | **Router** - Routes to the right skill | Always start here |
  86. | `clerk-cli` | Clerk CLI operations | Users, orgs, apps, env keys, deploy checks |
  87. | `clerk-setup` | Add Clerk to any framework | New projects, framework setup |
  88. | `clerk-migrate` | Migrate users into Clerk | Importing users from another auth provider, dev → prod |
  89. | `clerk-custom-ui` | Custom sign-in/up and appearance | Building custom forms, styling |
  90. | `clerk-backend-api` | Backend REST API explorer | Browsing or calling API endpoints |
  91. ### Framework Patterns
  92. | Skill | Framework | Patterns |
  93. |-------|-----------|----------|
  94. | `clerk-nextjs-patterns` | Next.js | Middleware, Server Actions, caching |
  95. | `clerk-react-patterns` | React | Hooks, auth guards, protected routes |
  96. | `clerk-react-router-patterns` | React Router | Loaders, actions, route protection |
  97. | `clerk-vue-patterns` | Vue | Composables, Pinia integration |
  98. | `clerk-nuxt-patterns` | Nuxt | Server middleware, SSR auth |
  99. | `clerk-astro-patterns` | Astro | SSR auth, island components |
  100. | `clerk-tanstack-patterns` | TanStack Start | Server functions, route protection |
  101. | `clerk-chrome-extension-patterns` | Chrome Extension | Background scripts, popup auth |
  102. ### Features
  103. | Skill | Purpose | When to Use |
  104. |-------|---------|-------------|
  105. | `clerk-orgs` | Multi-tenant B2B organizations | Team workspaces, RBAC |
  106. | `clerk-billing` | Subscription billing and feature gating | Pricing tables, plans, per-seat, entitlements |
  107. | `clerk-webhooks` | Real-time events and data syncing | Database sync, notifications |
  108. | `clerk-testing` | E2E testing for auth flows | Playwright/Cypress tests |
  109. ### Native Mobile
  110. | Skill | Platform | Patterns |
  111. |-------|----------|----------|
  112. | `clerk-swift` | iOS, macOS | ClerkKitUI views, custom ClerkKit flows, Sign in with Apple |
  113. | `clerk-android` | Android | Kotlin, Jetpack Compose |
  114. | `clerk-expo` | Expo / React Native | Native components, custom flows, SMS OTP, OAuth |
  115. ## Quick Start
  116. ### 1. Ask Your Agent to Add Clerk
  117. After installing Clerk Skills, ask your coding agent to add Clerk authentication
  118. to your app. The [`clerk-setup`](skills/clerk-setup/SKILL.md) skill sets up
  119. Clerk in an existing project, scaffolds a new app in an empty directory, and can
  120. link an existing Clerk application instead of creating a new one.
  121. For a new project on a supported framework, `clerk init` can start without a
  122. Clerk account or browser login. See [Accountless development keys](skills/clerk-setup/SKILL.md#step-1c-accountless-development-keys)
  123. for how temporary keys and later account claiming work.
  124. ### 2. Example Requests
  125. | You Say | Skill Used |
  126. |---------|------------|
  127. | "List Clerk users" | `clerk-cli` |
  128. | "Add Clerk auth to my Next.js app" | `clerk-setup` |
  129. | "Migrate my users from Auth0 to Clerk" | `clerk-migrate` |
  130. | "Use Server Actions with Clerk" | `clerk-nextjs-patterns` |
  131. | "Add Clerk to my Vue app" | `clerk-vue-patterns` |
  132. | "Add Clerk to my Nuxt app" | `clerk-nuxt-patterns` |
  133. | "Add auth to my Expo app" | `clerk-expo` |
  134. | "Add phone SMS auth to my Expo app" | `clerk-expo` |
  135. | "Add Clerk to my Astro site" | `clerk-astro-patterns` |
  136. | "Build custom sign-in form" | `clerk-custom-ui` |
  137. | "Sync users to Prisma via webhooks" | `clerk-webhooks` |
  138. | "Add Playwright tests for auth" | `clerk-testing` |
  139. | "Set up organizations for my B2B app" | `clerk-orgs` |
  140. | "Add subscription billing with pricing table" | `clerk-billing` |
  141. | "Gate features by plan" | `clerk-billing` |
  142. | "Add Clerk auth to my iOS app" | `clerk-setup` |
  143. | "Add a custom sign-in screen to my SwiftUI app" | `clerk-swift` |
  144. | "Add Clerk auth to my Android app" | `clerk-android` |
  145. ## Repository Structure
  146. ```
  147. clerk-skills/ # the repo root is the plugin root
  148. ├── skills/ # one folder per skill, flat
  149. │ ├── clerk/ # Router skill
  150. │ ├── clerk-setup/
  151. │ ├── clerk-nextjs-patterns/
  152. │ └── ...
  153. ├── plugin.json # Agent Plugins 1.0.0 manifest
  154. ├── mcp.json # Agent Plugins MCP config
  155. ├── .mcp.json # Claude Code and older Codex MCP config
  156. ├── .claude-plugin/ # plugin.json + marketplace.json
  157. ├── .cursor-plugin/ # plugin.json + marketplace.json
  158. ├── .codex-plugin/plugin.json
  159. ├── .antigravity-plugin/plugin.json # Antigravity manifest
  160. ├── mcp_config.json # Antigravity MCP config
  161. ├── .agents/plugins/marketplace.json # Codex marketplace
  162. ├── scripts/ # CI checkers, run with pnpm run check
  163. └── README.md
  164. ```
  165. ## Contributing
  166. This repo uses [pnpm](https://pnpm.io). If you've enabled Corepack, run `corepack disable pnpm` first; Corepack can't run pnpm 12.
  167. [Install pnpm](https://pnpm.io/installation), then run:
  168. ```bash
  169. pnpm install
  170. pnpm test # test the checkers
  171. pnpm run check # validate the skills
  172. ```
  173. ## Resources
  174. - [Clerk Docs](https://clerk.com/docs)
  175. - [Dashboard](https://dashboard.clerk.com)
  176. - [Discord](https://clerk.com/discord)
  177. ## Request a Skill
  178. Don't see what you need? [Request a skill](https://github.com/clerk/skills/issues/new?template=skill-request.md).
  179. ## License
  180. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.