clerk-common-errors

Featured

Troubleshoot common Clerk errors and issues. Use when encountering authentication errors, SDK issues, or configuration problems with Clerk. Trigger with phrases like "clerk error", "clerk not working", "clerk authentication failed", "clerk issue", "fix clerk".

AI & Automation 2,359 stars 334 forks Updated today MIT

Install

View on GitHub

Quality Score: 99/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Clerk Common Errors ## Overview Diagnose and resolve common Clerk authentication errors. Organized by error category with root cause analysis and fix code. ## Prerequisites - Clerk SDK installed - Access to Clerk Dashboard for configuration verification - Browser developer tools for client-side debugging ## Instructions ### Error Category 1: Configuration Errors **`Clerk: Missing publishableKey`** ```typescript // Cause: ClerkProvider not receiving key // Fix: Ensure env var is set and accessible // .env.local NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_... // Verify in code: console.log('PK:', process.env.NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY) // Should not be undefined ``` **`ClerkProvider must wrap your application`** ```typescript // Cause: Clerk hook used outside provider // Fix: Wrap root layout with ClerkProvider // app/layout.tsx import { ClerkProvider } from '@clerk/nextjs' export default function RootLayout({ children }: { children: React.ReactNode }) { return ( <ClerkProvider> <html><body>{children}</body></html> </ClerkProvider> ) } ``` ### Error Category 2: Authentication Errors **`form_identifier_not_found`** ```typescript // Cause: Email not registered in Clerk instance // Fix: Check correct Clerk instance (dev vs prod) and user exists // Diagnostic: import { createClerkClient } from '@clerk/backend' const clerk = createClerkClient({ secretKey: process.env.CLERK_SECRET_KEY! }) const users = await clerk.users.getUserList({ emailAddress: [...

Details

Author
jeremylongshore
Repository
jeremylongshore/claude-code-plugins-plus-skills
Created
8 months ago
Last Updated
today
Language
Python
License
MIT

Integrates with

Anthropic · AI Next.js · Frontend Clerk · Auth

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Featured

clerk-install-auth

Install and configure Clerk SDK/CLI authentication. Use when setting up a new Clerk integration, configuring API keys, or initializing Clerk in your project. Trigger with phrases like "install clerk", "setup clerk", "clerk auth", "configure clerk API key", "add clerk to project".

2,359 Updated today
jeremylongshore
AI & Automation Featured

clerk-sdk-patterns

Common Clerk SDK patterns and best practices. Use when implementing authentication flows, accessing user data, or integrating Clerk SDK methods in your application. Trigger with phrases like "clerk SDK", "clerk patterns", "clerk best practices", "clerk API usage".

2,359 Updated today
jeremylongshore
AI & Automation Featured

clerk-security-basics

Implement security best practices with Clerk authentication. Use when securing your application, reviewing auth implementation, or hardening Clerk configuration. Trigger with phrases like "clerk security", "secure clerk", "clerk best practices", "clerk hardening".

2,359 Updated today
jeremylongshore