clerk-auth

SKILL.md

Status: Production Ready ✅ Last Updated: 2025-10-28 Dependencies: None Latest Versions: @clerk/nextjs@6.33.3, @clerk/backend@2.17.2, @clerk/clerk-react@5.51.0, @clerk/testing@1.4.4

\\\`typescript import React from 'react' import ReactDOM from 'react-dom/client' import { ClerkProvider } from '@clerk/clerk-react' import App from './App.tsx' import './index.css'

// Get publishable key from environment const PUBLISHABLEKEY = import.meta.env.VITECLERKPUBLISHABLEKEY

Esta habilidad proporciona conocimientos integrales para integrar la autenticación de Clerk en aplicaciones React, Next.js y Cloudflare Workers. Debe usarse al configurar la autenticación de usuarios, implementar rutas protegidas, verificar tokens JWT, crear plantillas JWT personalizadas con metadatos de usuario y reclamos de la organización, configurar el middleware de Clerk, integrar con componentes shadcn/ui, probar flujos de autenticación o solucionar problemas de errores de autenticación de Clerk. Úselo cuando: agregar Clerk a proyectos React/Vite, configurar Clerk en Next.js App Router, implementar la autenticación de Clerk en Cloudflare Workers, configurar clerkMiddleware para protección de rutas, crear plantillas JWT personalizadas con códigos cortos (user.id, user.email, user.public_metadata.role), acceder a reclamos de sesión para RBAC, integrar con Supabase/Grafbase, verificar tokens con @clerk/backend, integrar Clerk con Hono, usando componentes Clerk shadcn/ui, escribiendo pruebas E2E con Playwright, generando tokens de sesión de prueba, usando direcciones de correo electrónico y números de teléfono de prueba, o encontrando errores de autenticación. Previene 11 problemas documentados: errores de clave secreta faltante, errores de migración de clave API, condiciones de carrera de caché de JWKS, vulnerabilidades CSRF por falta de partes autorizadas, errores de ruta de importación después de la actualización de Core 2, problemas de límite de tamaño de JWT, advertencias de versión de API obsoleta, errores de componente JSX de ClerkProvider, confusión del asistente async auth(), configuración incorrecta de variables de entorno y errores de encabezado 431 del modo de desarrollo de Vite. Palabras clave: empleado, autenticación de empleado, autenticación de empleado, @clerk/nextjs, @clerk/backend, @clerk/clerk-react, clerkMiddleware, createRouteMatcher, verificarToken, useUser, useAuth, useClerk, plantilla JWT, reclamos JWT, códigos cortos JWT, JWT personalizado, reclamos de sesión, plantilla getToken, user.public_metadata, org_id, org_slug, org_role, CustomJwtSessionClaims, metadatos de sessionClaims, webhook del empleado, clave secreta del empleado, clave publicable del empleado, rutas protegidas, autenticación de Cloudflare Workers, autenticación de Next.js, autenticación shadcn/ui, @hono/clerk-auth, "Falta la clave secreta del empleado", "no se puede utilizar como componente JSX", error JWKS, Partes autorizadas, middleware de empleado, ClerkProvider, UserButton, Iniciar sesión, Registrarse, prueba de empleado, correos electrónicos de prueba, números de teléfono de prueba, +clerk_test, 424242 OTP, token de sesión, token de prueba, @clerk/testing, prueba de dramaturgo, prueba E2E, modo de prueba de empleado, detección de bot, generar token de sesión, usuarios de prueba Fuente: jackspace/claudeskillz.

Ver original