clerk-common-errors

Skill do debugowania typowych problemów z Clerk — od brakujących kluczy konfiguracyjnych po błędy autentykacji. Zawiera katalog błędów pogrupowanych po kategoriach, analizę przyczyn i gotowy kod naprawczy. Użyj go, gdy napotkasz komunikaty o błędach Clerk, problemy z SDK lub konfigurację providera. Obsługuje środowiska Next.js i wymaga dostępu do Clerk Dashboard.

1. Upewnij się, że masz zainstalowany Clerk SDK w swoim projekcie oraz dostęp do Clerk Dashboard do weryfikacji ustawień.

2. Wyzwól skill frazami takimi jak "clerk error", "clerk nie działa", "clerk authentication failed" lub "fix clerk", gdy napotkasz problem z autentykacją.

3. Dla błędu "Missing publishableKey" — sprawdź, czy zmienna środowiskowa NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY jest ustawiona w pliku .env.local i zawiera prawidłowy klucz (zaczynający się od pk_test_ lub pk_live_). Zweryfikuj w konsoli, czy process.env.NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY nie zwraca undefined.

4. Dla błędu "ClerkProvider must wrap your application" — upewnij się, że komponent ClerkProvider opakowuje całą aplikację w pliku root layout (np. app/layout.tsx w Next.js), a wszystkie hooki Clerk są używane wewnątrz tego providera.

5. Dla błędu "form_identifier_not_found" — sprawdź, czy używasz prawidłowej instancji Clerk (środowisko deweloperskie vs produkcyjne) i czy użytkownik faktycznie istnieje w systemie. Możesz to zweryfikować za pomocą Clerk Backend API, podając odpowiedni secretKey.

6. Użyj dostępnych narzędzi (Read, Write, Edit, Grep, Bash z npm) do przeglądania logów, edycji plików konfiguracyjnych i uruchamiania diagnostyki w terminalu.