# Clerk Skills

[Clerk Skills](https://github.com/clerk/skills) are installable packages that give AI coding agents specialized knowledge about Clerk. Once installed, your agent can help you add authentication, manage organizations, sync users, and more.

## Installation

To install all available Skills, use:

```bash
npx skills add clerk/skills
```

To install a specific Skill, use:

```bash
npx skills add clerk/skills --skill {skill-name}
```

Works with Claude Code, Cursor, Windsurf, GitHub Copilot, Codex, Gemini CLI, and more. See [all supported agents](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents).

## Available skills

The following table lists the available Skills. See the linked reference for more information about each Skill.

### Core

| Skill                                                                                                  | Description                            | When to use                                        |
| ------------------------------------------------------------------------------------------------------ | -------------------------------------- | -------------------------------------------------- |
| [/clerk](https://github.com/clerk/skills/blob/main/skills/core/clerk/SKILL.md)                         | Router - routes to the right skill     | Always start here                                  |
| [/clerk-setup](https://github.com/clerk/skills/blob/main/skills/core/clerk-setup/SKILL.md)             | Add Clerk to any framework             | New projects, framework setup                      |
| [/clerk-custom-ui](https://github.com/clerk/skills/blob/main/skills/core/clerk-custom-ui/SKILL.md)     | Custom sign-in/up flows and appearance | Building custom forms, styling, branding           |
| [/clerk-backend-api](https://github.com/clerk/skills/blob/main/skills/core/clerk-backend-api/SKILL.md) | Backend REST API explorer              | Browsing and executing Clerk Backend API endpoints |

### Features

| Skill                                                                                                | Description                                           | When to use                                                                                          |
| ---------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| [/clerk-orgs](https://github.com/clerk/skills/blob/main/skills/features/clerk-orgs/SKILL.md)         | Multi-tenant business-to-business (B2B) organizations | Team workspaces, role-based access control (RBAC), verified domains, enterprise single sign-on (SSO) |
| [/clerk-testing](https://github.com/clerk/skills/blob/main/skills/features/clerk-testing/SKILL.md)   | End-to-end (E2E) testing for auth flows               | Writing Playwright/Cypress tests                                                                     |
| [/clerk-webhooks](https://github.com/clerk/skills/blob/main/skills/features/clerk-webhooks/SKILL.md) | Real-time events and data syncing                     | Database sync, notifications, integrations                                                           |

### Frameworks

| Skill                                                                                                                                    | Description                   | When to use                                          |
| ---------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- | ---------------------------------------------------- |
| [/clerk-nextjs-patterns](https://github.com/clerk/skills/blob/main/skills/frameworks/clerk-nextjs-patterns/SKILL.md)                     | Advanced Next.js patterns     | Server Actions, middleware, caching                  |
| [/clerk-react-patterns](https://github.com/clerk/skills/blob/main/skills/frameworks/clerk-react-patterns/SKILL.md)                       | React SPA patterns (Vite/CRA) | ClerkProvider, hooks, protected routes               |
| [/clerk-expo-patterns](https://github.com/clerk/skills/blob/main/skills/frameworks/clerk-expo-patterns/SKILL.md)                         | Expo / React Native patterns  | SecureStore, OAuth deep linking, Expo Router         |
| [/clerk-tanstack-patterns](https://github.com/clerk/skills/blob/main/skills/frameworks/clerk-tanstack-patterns/SKILL.md)                 | TanStack React Start patterns | createServerFn, beforeLoad guards, loaders           |
| [/clerk-react-router-patterns](https://github.com/clerk/skills/blob/main/skills/frameworks/clerk-react-router-patterns/SKILL.md)         | React Router v7 patterns      | rootAuthLoader, getAuth in loaders, SSR              |
| [/clerk-astro-patterns](https://github.com/clerk/skills/blob/main/skills/frameworks/clerk-astro-patterns/SKILL.md)                       | Astro patterns                | Middleware, SSR pages, island components, API routes |
| [/clerk-chrome-extension-patterns](https://github.com/clerk/skills/blob/main/skills/frameworks/clerk-chrome-extension-patterns/SKILL.md) | Chrome Extension auth         | Popup/sidepanel, syncHost, service workers           |
| [/clerk-nuxt-patterns](https://github.com/clerk/skills/blob/main/skills/frameworks/clerk-nuxt-patterns/SKILL.md)                         | Nuxt 3 patterns               | Middleware, composables, server API routes, SSR      |
| [/clerk-vue-patterns](https://github.com/clerk/skills/blob/main/skills/frameworks/clerk-vue-patterns/SKILL.md)                           | Vue 3 patterns                | Composables, Vue Router guards, Pinia                |

### Mobile

| Skill                                                                                            | Description                          | When to use                          |
| ------------------------------------------------------------------------------------------------ | ------------------------------------ | ------------------------------------ |
| [/clerk-android](https://github.com/clerk/skills/blob/main/skills/mobile/clerk-android/SKILL.md) | Native Android/Kotlin authentication | Building native Android/Compose apps |
| [/clerk-swift](https://github.com/clerk/skills/blob/main/skills/mobile/clerk-swift/SKILL.md)     | Native iOS/SwiftUI authentication    | Building native Swift/iOS apps       |

## Example prompts

Once Skills are installed, you can ask your AI agent:

| You say                                      | Skill used                         |
| -------------------------------------------- | ---------------------------------- |
| "Add Clerk auth to my Next.js app"           | `/clerk-setup`                     |
| "Build custom sign-in form with styling"     | `/clerk-custom-ui`                 |
| "List all user endpoints in the Backend API" | `/clerk-backend-api`               |
| "Set up organizations for my B2B app"        | `/clerk-orgs`                      |
| "Add Playwright tests for auth"              | `/clerk-testing`                   |
| "Sync users to Prisma via webhooks"          | `/clerk-webhooks`                  |
| "Use Server Actions with Clerk"              | `/clerk-nextjs-patterns`           |
| "Add Clerk auth to my Vite React app"        | `/clerk-react-patterns`            |
| "Add auth to my Expo / React Native app"     | `/clerk-expo-patterns`             |
| "Add Clerk to my TanStack Start app"         | `/clerk-tanstack-patterns`         |
| "Protect routes in my React Router v7 app"   | `/clerk-react-router-patterns`     |
| "Set up Clerk in Astro with SSR"             | `/clerk-astro-patterns`            |
| "Sign users in from a Chrome extension"      | `/clerk-chrome-extension-patterns` |
| "Add auth to my Nuxt 3 app"                  | `/clerk-nuxt-patterns`             |
| "Use Clerk composables in Vue"               | `/clerk-vue-patterns`              |
| "Integrate Clerk in my Android Compose app"  | `/clerk-android`                   |
| "Add Clerk auth to my SwiftUI app"           | `/clerk-swift`                     |

---

## Sitemap

[Overview of all docs pages](https://clerk.com/docs/llms.txt)
