sr-next-clerk-expert
von michaelmonetized
Web & Frontend DevelopmentKurzbeschreibung
Senior-level Clerk authentication expertise for Next.js 15/16+ applications.
Beschreibung
Was dieser Skill macht
Provides senior-level patterns for implementing Clerk authentication in Next.js 15/16+ apps. Covers route protection, middleware configuration, client vs server auth boundaries, and integration with Convex and Stripe. Includes a set of rules that prevent common auth failures like 500 errors, infinite redirects, and handshake loops.
Encodes hard-won production rules that are not obvious from Clerk's official docs, preventing outages caused by calling auth() on public pages or skipping ClerkLoaded wrappers.
Wann du ihn einsetzt
- Protecting dashboard routes while keeping marketing pages public
- Migrating from middleware.ts to proxy.ts for Next.js 16+
- Debugging Clerk handshake redirects and 500 errors in production
- Adding Stripe billing flows to an existing Clerk-authenticated app
- Syncing Clerk users to a Convex database via webhooks
Beispiel-Workflow
User asks: How do I protect my dashboard routes but keep the homepage public in Next.js 16+?
- 1
Creates app/(private)/ route group containing dashboard and settings pages
- 2
Generates proxy.ts using clerkMiddleware that only protects /(private)(.*) routes
- 3
Creates app/(private)/layout.tsx that calls auth() and redirects unauthenticated users
- 4
Updates app/page.tsx to use SignedIn/SignedOut inside ClerkLoaded instead of calling auth()
- 5
Provides verification checklist to test anonymous access before deploying
Working route protection setup where public pages remain static and only private routes require authentication
Voraussetzungen
- CLERK_SECRET_KEY environment variable (from Clerk Dashboard)
- NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY environment variable (from Clerk Dashboard)
- Clerk account
Installation
clawhub install michaelmonetized/sr-next-clerk-expertFühre den CLI-Befehl aus oder füge den Prompt in Claude Code, Cursor, Codex oder deinen Coding-Agenten ein.