Completar auth y clientes de Edge Functions con supabase/server

Install

npx skills add supabase/server

Para quién

Este skill encaja en quien escribe Edge Functions o APIs y no quiere reescribir a mano auth, creación de cliente y CORS. Oficialmente es una envoltura de servidor: auth, creación de cliente e inyección de contexto las gestiona él, tú escribes la lógica de negocio. También encaja en quien ya usa un agente de código IA — el texto fuente dice que puedes instalar el skill en agentes como Claude Code y Cursor.

No encaja en quien solo hace páginas de navegador y nunca toca una entrada de servidor. La petición debe entrar en Edge Functions o una API para que la creación de cliente y el auth queden acotados automáticamente a la petición entrante. Si aún no hay un agente que pueda instalar skills, confirma que puedes ejecutar el comando oficial de instalación antes de seguir. Una comprobación de solo lectura también vale: pide al agente que explique cómo envolver fetch con una línea de configuración y no cambies aún las funciones de producción. El repositorio oficial es

https://github.com/supabase/server

Sigue los comandos ya escritos en esa página.

Primera prueba en 3 minutos

Sigue solo el único camino de instalación de skill que escribe el texto oficial.

Requisito: esta máquina puede ejecutar npx y usas uno de los agentes de código IA nombrados en el texto, por ejemplo Claude Code o Cursor. Abrir el proyecto donde sueles escribir Edge Functions o APIs basta. Este paso es una comprobación de explicación; no cambies código en vivo ni envíes peticiones hacia fuera.

Lugar de instalación: en un terminal en la raíz del proyecto, ejecuta:

npx skills add supabase/server

Ese comando instala el skill en el agente actual. El texto oficial también dice: en Deno o Supabase Edge Functions puedes no instalar un paquete e importar directo desde npm:@supabase/server.

Dispara una tarea de bajo riesgo: pide al agente que ya tiene el skill que liste en texto «cómo envolver fetch con withSupabase para que la función de tratamiento solo entre tras auth correcta», y que escriba la sentencia de importación. No escribas archivos, no llames interfaces externas, no despliegues.

Señal de éxito: el agente puede restablecer que tras una importación y una línea de configuración el auth se comprueba, el cliente está listo, CORS se trata y la función de tratamiento solo corre tras auth correcta; y da import { withSupabase } from "npm:@supabase/server". Si inventa otro comando de instalación, vuelve al comando oficial de arriba y reintenta.

Casos de uso

Caso 1: añadir la envoltura oficial a la entrada fetch de una Edge Function o API existente. El camino principal del texto es envolver fetch con withSupabase: tras una importación y una línea de configuración, el auth ya está comprobado, el cliente listo, CORS tratado, y la función de tratamiento solo corre si el auth acierta. Puedes pedir primero al agente que marque la entrada a cambiar y el código de negocio a dejar igual, y actuar tras confirmar. Si el texto no tiene un ejemplo de función completo, detente en «la entrada está envuelta y un auth fallido no entra en la función de tratamiento»; no inventes una tabla de rutas ni un esquema de secretos.

Caso 2: importar directo en Deno o Supabase Edge Functions en vez de instalar un paquete primero. El texto dice que ese entorno puede saltarse la instalación y usar import { withSupabase } from "npm:@supabase/server" directo. Encaja en quien ya escribe funciones de tratamiento en ese runtime y solo quiere comprobar la ruta de importación. Confirma primero que la importación aplica al runtime del archivo actual; si el proyecto no es Deno ni Edge Functions, el texto se detiene aquí — no lo extiendas a un runtime no nombrado.

Límites de uso

El texto solo cubre la entrada de servidor: creación de cliente y auth se acotan automáticamente a las peticiones entrantes que entran en Edge Functions y APIs. No prueba el uso en páginas de navegador, tareas programadas de fondo ni alojamientos no nombrados.

Solo hay un comando de instalación de skill escrito: npx skills add supabase/server. No pongas un instalador que no aparece en el camino principal. Claude Code, Cursor y otros son un conjunto de ejemplos, no los únicos dos agentes admitidos.

En el uso del paquete, el texto da la importación directa para Deno / Supabase Edge Functions y envolver fetch con withSupabase. Si no ves nombres de variables de entorno, interruptores detallados de CORS ni una política de reintento, no los inventes. La función de tratamiento solo corre tras auth correcta; qué código de estado se devuelve al fallar no está escrito. La página oficial es