Install
npx skills add clerk/skillsPara quién
Usa este conjunto de skills cuando quieras que un Agent de código gestione la autenticación Clerk con más fluidez, sobre todo para añadir Clerk a un proyecto nuevo o a cualquier framework, o para comprobar usuarios, organizaciones, apps, claves de entorno y despliegues. Los skills siguen el formato Agent Skills y van a desarrolladores que necesitan Clerk en el repositorio y quieren que el Agent elija el skill correcto antes de tocar nada. El texto oficial marca /clerk como enrutador y dice empezar siempre ahí; no nombres un skill hijo de entrada. Antes de empezar debes poder abrir Clerk Dashboard y obtener claves que se puedan escribir en un archivo de entorno; si no, la integración y las comprobaciones se detienen por falta de claves.
Completa el primer intento en 3 minutos
Sigue solo el comando de instalación del repositorio oficial:
npx skills add clerk/skills
Tras instalar, prepara primero las claves; no rellenes con marcadores. Abre Clerk Dashboard, copia la clave publicable y la clave secreta y escríbelas en el .env del proyecto. Los nombres de clave deben ser NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY y CLERK_SECRET_KEY. Antes de escribir, haz que el Agent solo repita esos dos nombres y el archivo destino; permite el cambio solo después de confirmar.
En la primera tarea elige una comprobación reversible, no un cambio de framework. En un cliente que ya cargó los skills, escribe /clerk, di que quieres una comprobación de despliegue o verificar claves de entorno, y deja que el enrutador te lleve a clerk-cli. Antes de cualquier comando, exige que el Agent diga que llamará una comprobación CLI y no creará usuarios ni cambiará organizaciones. Ejecuta solo tras confirmar.
Señal de éxito: el Agent pasa de /clerk a clerk-cli y devuelve resultados de claves de entorno o de comprobación de despliegue, no errores de skill o clave faltantes. Si usas Codex, el texto oficial tiene un comando de alta en el marketplace aparte; después de añadir, reinicia, abre /plugins, elige Clerk Skills, instala y activa clerk-skills y abre un hilo nuevo. Esa secuencia es solo de Codex; no la trates como instalación por defecto.
Casos de uso
Caso 1: integrar un proyecto nuevo o cualquier framework. El skill oficial clerk-setup añade Clerk a cualquier framework, para proyectos nuevos e init de framework. El camino es primero /clerk, indicar el framework actual y «solo añadir la integración Clerk», y dejar que el enrutador aterrice en clerk-setup. Este tipo de tarea cambia archivos del proyecto; el Agent debe listar los archivos que cambiará y tú confirmas antes de escribir. La página no da una lista concreta de frameworks ni parches paso a paso; el detalle de framework sigue las notas del skill tras instalar.
Caso 2: comprobaciones operativas de solo lectura por CLI. clerk-cli cubre usuarios, organizaciones, apps, claves de entorno y comprobaciones de despliegue. Tras escribir las claves en .env, sirve para ver si una app existente se puede desplegar, si las claves están completas o para ver usuarios y organizaciones en solo lectura. Otra vez /clerk primero y luego clerk-cli. La página no lista subcomandos CLI concretos; no inventes nombres de comando. Lo confirmable son las categorías de comprobación anteriores; el formato de salida sigue la ejecución real.
Límites de uso
Sin claves del Dashboard no empieces la integración. El archivo de entorno usa solo los dos nombres que escribió el texto oficial; no los cambies por variables no documentadas. La instalación por defecto es npx skills add clerk/skills; la del marketplace solo vale para Codex y debe activar clerk-skills en el orden oficial. Empieza siempre por /clerk; la página no presenta otras entradas como forma de saltarse el enrutador. El texto oficial no lista un roster completo de clientes; no infieras soporte exclusivo del ejemplo de Codex ni cobertura de idiomas de los ejemplos de la página. No completes directorios de skills, comandos de marketplace ni muestras de claves no escritos. Página del repositorio:
https://github.com/clerk/skills
Dashboard:
https://dashboard.clerk.com/