aa71e76eb9
- Add date_added to all 950+ skills for complete tracking - Update version to 6.5.0 in package.json and README - Regenerate all indexes and catalog - Sync all generated files Features from merged PR #150: - Stars/Upvotes system for community-driven discovery - Auto-update mechanism via START_APP.bat - Interactive Prompt Builder - Date tracking badges - Smart auto-categorization All skills validated and indexed. Made-with: Cursor
62 lines
1.6 KiB
Markdown
62 lines
1.6 KiB
Markdown
---
|
|
name: clerk-auth
|
|
description: "Expert patterns for Clerk auth implementation, middleware, organizations, webhooks, and user sync Use when: adding authentication, clerk auth, user authentication, sign in, sign up."
|
|
risk: unknown
|
|
source: "vibeship-spawner-skills (Apache 2.0)"
|
|
date_added: "2026-02-27"
|
|
---
|
|
|
|
# Clerk Authentication
|
|
|
|
## Patterns
|
|
|
|
### Next.js App Router Setup
|
|
|
|
Complete Clerk setup for Next.js 14/15 App Router.
|
|
|
|
Includes ClerkProvider, environment variables, and basic
|
|
sign-in/sign-up components.
|
|
|
|
Key components:
|
|
- ClerkProvider: Wraps app for auth context
|
|
- <SignIn />, <SignUp />: Pre-built auth forms
|
|
- <UserButton />: User menu with session management
|
|
|
|
|
|
### Middleware Route Protection
|
|
|
|
Protect routes using clerkMiddleware and createRouteMatcher.
|
|
|
|
Best practices:
|
|
- Single middleware.ts file at project root
|
|
- Use createRouteMatcher for route groups
|
|
- auth.protect() for explicit protection
|
|
- Centralize all auth logic in middleware
|
|
|
|
|
|
### Server Component Authentication
|
|
|
|
Access auth state in Server Components using auth() and currentUser().
|
|
|
|
Key functions:
|
|
- auth(): Returns userId, sessionId, orgId, claims
|
|
- currentUser(): Returns full User object
|
|
- Both require clerkMiddleware to be configured
|
|
|
|
|
|
## ⚠️ Sharp Edges
|
|
|
|
| Issue | Severity | Solution |
|
|
|-------|----------|----------|
|
|
| Issue | critical | See docs |
|
|
| Issue | high | See docs |
|
|
| Issue | high | See docs |
|
|
| Issue | high | See docs |
|
|
| Issue | medium | See docs |
|
|
| Issue | medium | See docs |
|
|
| Issue | medium | See docs |
|
|
| Issue | medium | See docs |
|
|
|
|
## When to Use
|
|
This skill is applicable to execute the workflow or actions described in the overview.
|