Agent skill · software engineering · jeremylongshore
clerk-local-dev-loop
Set up local development workflow with Clerk.
Why this skill is useful
Adds executable scripts for setting up a local development environment with Clerk authentication, including test user creation and hot reload configuration.
What it needs
Requires node installed locally. Requires clerk account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Clerk Local Dev Loop Overview Configure an efficient local development workflow with Clerk authentication, including test users, hot reload, and mock auth for unit tests. Prerequisites Clerk SDK installed (clerk-install-auth completed) Development instance created in Clerk Dashboard Node.js development environment Instructions Step 1: Configure Development Instance Create a separate Clerk development instance to isolate test data from production. Clerk development instances provide: No email verification required Test phone numbers accepted Relaxed rate limits OAuth with test credentials Step 2: Set Up Test Users Run with: Step 3: Configure Hot Reload Step 4: Development Scripts Step 5: Mock Authentication for Tests Output Development instance with test keys configured Test users seeded via script HTTPS dev server running for Clerk compatibility Vitest mock helpers for auth in unit tests Error Handling Error Cause Solution ------- ------- ---------- Dev/prod key mismatch Using pklive in dev Switch to pktest / sktest keys SSL required Clerk needs HTTPS locally Run next dev --experimental-https Cookies not set Wrong domain config Check Clerk Dashboard domain settings Session not persisting Browser storage issue Clear cookies, check localhost domain Examples Playwright Auth Fixture for E2E Tests Resources Clerk Development Mode Clerk Testing Guide Next.js HTTPS Dev Next Steps Proceed to clerk-sdk-patterns for common SDK usage patterns.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/clerk-local-dev-loop