better-auth-best-practices

Visión general de la skill better-auth-best-practices

La skill better-auth-best-practices es una guía práctica de configuración para integrar Better Auth correctamente, especialmente cuando necesitas algo más que un prompt genérico de “añade auth”. Está pensada para desarrolladores que usan Better Auth en aplicaciones TypeScript y necesitan ayuda con la configuración inicial, la ubicación de auth.ts, las variables de entorno, los adaptadores de base de datos, la conexión de rutas, las migraciones, las sesiones y una configuración compatible con plugins.

Para qué sirve realmente esta skill

Usa better-auth-best-practices cuando el objetivo sea conseguir que una integración de Better Auth funcione con menos errores evitables. La skill destaca especialmente al convertir solicitudes vagas como “configura Better Auth en mi app” en un plan de implementación más completo, con los pasos de instalación correctos, las expectativas de archivos y las comprobaciones de validación adecuadas.

Usuarios para los que mejor encaja

Esta skill encaja bien para:

• desarrolladores que añaden Better Auth a una app nueva o existente
• agentes que ayudan con auth.ts, adaptadores, sesiones, plugins o configuración de variables de entorno
• equipos que quieren un punto de partida más seguro antes de consultar ejemplos oficiales

Es especialmente útil si ya conoces tu framework y tu base de datos, pero necesitas una ruta fiable para configurar Better Auth.

Qué la diferencia de un prompt normal

Un prompt normal puede generar código de autenticación plausible, pero pasar por alto detalles específicos de Better Auth. La better-auth-best-practices skill añade orientación respaldada por el repositorio sobre:

• variables de entorno obligatorias como BETTER_AUTH_SECRET y BETTER_AUTH_URL
• dónde espera la CLI encontrar auth.ts
• cuándo ejecutar comandos de migración o generación de esquema
• la necesidad de volver a ejecutar pasos de la CLI tras cambios en plugins
• una comprobación de estado sencilla tras la instalación usando GET /api/auth/ok

Eso la hace más útil para instalación y troubleshooting que una petición amplia del tipo “construye un login”.

Lo que no sustituye

Esta skill no sustituye la documentación oficial en vivo de Better Auth. El repositorio indica explícitamente que los usuarios consulten https://better-auth.com/docs para ver ejemplos de código actualizados y cambios en la API. Toma la skill como un acelerador de configuración y una ayuda para decidir, y después valida el código específico de tu framework en la documentación.

Decisión clave de adopción

Instala better-auth-best-practices si quieres orientación específica de Better Auth con detalles operativos reales. Omítela si necesitas un starter completo de framework, una revisión de seguridad de producción o una arquitectura avanzada de autorización más allá de la integración inicial de Better Auth.

Cómo usar la skill better-auth-best-practices

Instala la skill better-auth-best-practices

Instálala con:

npx skills add https://github.com/better-auth/skills --skill best-practices

Esto añade la guía better-auth-best-practices desde el repositorio better-auth/skills.

Lee primero la fuente correcta

Esta skill es compacta. Empieza por:

• better-auth/best-practices/SKILL.md

No hay references/, rules/ ni scripts auxiliares adicionales en esta carpeta de la skill, así que casi toda la orientación útil está en ese único archivo.

Ten claro el contexto mínimo de instalación que espera

Antes de invocar la skill, reúne estas entradas:

• framework o runtime
• base de datos elegida y adaptador
• si quieres email/password, OAuth o ambos
• la ruta esperada para los handlers de auth
• si se necesitan plugins
• dónde debería vivir auth.ts en tu repositorio

Sin esos datos, la salida a menudo se quedará demasiado genérica.

Empieza por el flujo integrado de Better Auth

El repositorio propone una secuencia directa:

1. npm install better-auth
2. establecer BETTER_AUTH_SECRET y BETTER_AUTH_URL
3. crear auth.ts con base de datos y configuración
4. crear el route handler del framework
5. ejecutar npx @better-auth/cli@latest migrate
6. verificar con GET /api/auth/ok

Si tu prompt no incluye estos puntos de control, pídele al modelo que estructure su respuesta en torno a ellos.

Usa el comando CLI correcto para tu configuración

La skill subraya una distinción importante:

• npx @better-auth/cli@latest migrate para el flujo con adaptador integrado
• npx @better-auth/cli@latest generate para generación de esquema con Prisma o Drizzle

Esto importa porque “ejecuta la CLI de Better Auth” es demasiado vago. Si usas Prisma o Drizzle, indícalo explícitamente en tu prompt para que la salida use generate en lugar de recurrir por defecto a migrate.

Sé explícito con la ubicación del archivo auth.ts

La CLI de Better Auth busca auth.ts en:

• ./
• ./lib
• ./utils
• rutas dentro de ./src

Si tu proyecto usa una ubicación personalizada, indícale al agente que use --config. Este es uno de los bloqueos de adopción más comunes, porque el código puede parecer correcto mientras la CLI sigue sin encontrar el archivo de configuración.

Incluye en el prompt las decisiones sobre variables de entorno

La skill destaca dos variables clave:

• BETTER_AUTH_SECRET
• BETTER_AUTH_URL

También señala que solo debes definir baseURL o secret en la configuración si esas variables de entorno no están definidas. Ese detalle evita configuraciones duplicadas o en conflicto. Para obtener una salida de mayor calidad, especifica:

• URLs base de local y producción
• cómo se gestionan los secretos
• si se usan .env.local, secretos de plataforma o variables de entorno en Docker

Convierte una petición básica en un prompt sólido para better-auth-best-practices

Prompt débil:

• “Configura Better Auth para mi app”

Prompt más sólido:

• “Usa la skill better-auth-best-practices para configurar Better Auth en una app Next.js con TypeScript, PostgreSQL y Drizzle. Coloca auth.ts en src/lib. Necesitamos email/password ahora y Google OAuth más adelante. Muestra las variables de entorno obligatorias, la ubicación del route handler, si hay que ejecutar generate o migrate, y cómo verificar la configuración con /api/auth/ok.”

Por qué funciona:

• el framework está claro
• la ruta del adaptador está clara
• la ubicación del archivo está clara
• los métodos de autenticación están claros
• la elección de CLI deja de ser ambigua
• la verificación está incluida

Pide la respuesta en orden de implementación

Para sacar el máximo partido al uso de better-auth-best-practices, pide la respuesta con este formato:

1. paquetes que instalar
2. variables de entorno
3. auth.ts
4. route handler
5. comando de migración o esquema
6. adición de plugins
7. pasos de verificación
8. puntos probables de fallo

Esa estructura encaja con los puntos fuertes de la skill y reduce idas y vueltas.

Usa prompts conscientes de los plugins

La skill advierte explícitamente que hay que volver a ejecutar la CLI después de añadir o cambiar plugins. Si tu configuración depende de plugins, incluye ese requisito desde el principio. De lo contrario, el modelo puede generar una configuración base válida, pero pasar por alto cambios de esquema o migración introducidos por los plugins.

Valida la integración antes de ampliar el alcance

No saltes directamente de la instalación a flujos completos de UI. Primero confirma:

• que las variables de entorno se cargan
• que auth.ts es localizable
• que la CLI terminó correctamente
• que GET /api/auth/ok devuelve { status: "ok" }

Este es el punto de control práctico que más mejora el éxito de la instalación.

Mejor flujo de better-auth-best-practices para Access Control

Para better-auth-best-practices for Access Control, usa primero la skill para la base de autenticación y luego añade los requisitos de autorización por encima. Un buen prompt sería:

• “Configura primero Better Auth y luego muestra dónde deberían añadirse las comprobaciones de roles o permisos en los route handlers, el manejo de sesiones o la configuración de plugins. Separa lo que resuelve la configuración de Better Auth de lo que debe aplicar el control de acceso a nivel de aplicación.”

Esto evita que el modelo dé a entender en exceso que la configuración de Better Auth por sí sola resuelve toda la lógica de autorización.

FAQ de la skill better-auth-best-practices

¿Esta skill es buena para primeras instalaciones de Better Auth?

Sí. La skill es más útil en la primera instalación porque cubre las decisiones recurrentes de configuración que la gente suele pasar por alto: variables de entorno, ubicación de archivos, uso de la CLI y verificación. Aporta menos valor cuando tu integración ya es estable y solo necesitas consultar un detalle pequeño de la API.

¿better-auth-best-practices basta sin la documentación?

No. El propio repositorio dice que consultes better-auth.com/docs para ver ejemplos actuales y los últimos detalles de la API. Usa la skill para mejorar la calidad de la configuración y reducir suposiciones, y luego confirma la implementación exacta en la documentación.

¿Cuándo es mejor que un prompt de IA normal?

Es mejor cuando la tarea es específica de Better Auth y sensible a la instalación. Un prompt genérico puede omitir:

• expectativas sobre la longitud de BETTER_AUTH_SECRET
• BETTER_AUTH_URL
• rutas de detección de auth.ts
• la diferencia entre generate y migrate
• volver a ejecutar pasos de la CLI tras cambios en plugins

¿La guía better-auth-best-practices es específica de un framework?

No del todo. Ofrece un flujo portable de Better Auth, pero sigues necesitando el código de rutas y handlers específico de tu framework desde la documentación oficial o desde el contexto de tu app. Si no indicas tu framework, espera una orientación más amplia.

¿Los principiantes pueden usar la skill better-auth-best-practices?

Sí, pero los principiantes deberían aportar más contexto del que creen necesario. Como mínimo, incluye framework, base de datos y métodos de login deseados. De lo contrario, la salida puede ser técnicamente correcta, pero no directamente ejecutable.

¿Cubre Access Control de punta a punta?

No por sí sola. better-auth-best-practices for Access Control es útil para establecer la configuración de auth e identificar dónde se conectan las cuestiones de autorización, pero sigues necesitando reglas de permisos específicas de la aplicación, rutas protegidas y una estrategia de aplicación.

¿Cuándo no debería usar esta skill?

Omítela si:

• no estás usando Better Auth
• solo necesitas un ejemplo exacto de API de la documentación
• necesitas una auditoría completa de seguridad para producción
• tu problema principal es el diseño de autorización de la app, no la instalación de Better Auth

Cómo mejorar la skill better-auth-best-practices

Dale a la skill datos concretos de tu proyecto

La forma más rápida de mejorar la salida es proporcionar:

• framework
• runtime
• base de datos y ORM
• ubicación de auth.ts
• métodos de login
• lista de plugins
• entorno de despliegue

La skill better-auth-best-practices se vuelve mucho más accionable cuando esos detalles están claros.

Pídele que resuelva pronto los puntos probables de fallo

Un prompt sólido incluye:

• “Enumera los errores de configuración más comunes para este stack”
• “Dime si la CLI no podrá encontrar auth.ts”
• “Indica si debo usar generate o migrate y por qué”
• “Muestra cómo las variables de entorno sobrescriben los valores de configuración”

Estas preguntas generan una mejor guía de instalación que pedir solo código.

Pide verificación, no solo código

Muchas salidas malas sobre auth parecen completas, pero no están probadas. Pide al modelo que incluya:

• el resultado esperado de GET /api/auth/ok
• cómo se ve un resultado correcto tras ejecutar el comando CLI
• qué revisar si falla la ruta
• qué volver a comprobar después de añadir plugins

Esto mejora más la utilidad en la primera iteración que pedir ejemplos de código más largos.

Mejora los prompts de better-auth-best-practices para Access Control

Si tu objetivo incluye autorización, separa las preocupaciones en la petición:

• “Parte 1: instalación de Better Auth”
• “Parte 2: forma de la sesión y claims”
• “Parte 3: protección de rutas a nivel de aplicación y comprobaciones de permisos”

Eso evita que la respuesta mezcle pasos de configuración con lógica de acceso específica del negocio.

Itera después de la primera respuesta

Tras la primera pasada, refina con seguimientos concretos como:

• “Reescríbelo para Prisma en lugar del adaptador integrado”
• “Mueve auth.ts a src/utils”
• “Añade cambios de plugins y dime qué comando CLI debo volver a ejecutar”
• “Adáptalo al manejo de variables de entorno en producción”

La skill responde mejor a ajustes concretos que a peticiones amplias como “mejóralo”.

Vigila los principales modos de fallo

Las salidas débiles más probables son:

• variables de entorno ausentes
• suposiciones incorrectas sobre la ruta del archivo
• comando CLI incorrecto para el stack de adaptadores
• ninguna mención a volver a ejecutar la CLI tras cambios en plugins
• ningún paso de validación después de la configuración

Si falta alguno de estos puntos, pide una respuesta corregida antes de implementarla.

Usa la skill como lente de configuración, no como autoridad final

Para sacar el máximo partido a la better-auth-best-practices skill, úsala para dar forma a un plan de instalación limpio y luego verifica la sintaxis exacta y el código específico del framework en https://better-auth.com/docs. Esa combinación es la forma más segura de convertir la skill en una integración que funcione.