Instalar Supabase Skills para el Agent con el comando oficial

Para quién

Esta guía es para quienes ya usan, o van a usar, un AI Agent para desarrollo con Supabase. Oficialmente está escrita como Agent Skills que ayudan a los desarrolladores a usar Supabase en AI agents.

Antes de empezar, confirma que esta máquina puede ejecutar npx y que el directorio actual es el proyecto donde quieres escribir los archivos de skills. La página indica compatibilidad con 18+ AI agents, incluidos Claude Code, GitHub Copilot, Cursor, Cline y muchos otros; es una nota de compatibilidad, no una lista exclusiva, y no debes inferir un rango de lenguajes a partir de la lista de productos.

Tras instalar, las skills quedan disponibles automáticamente y el Agent las usa cuando detecta tareas relevantes. En el primer intento no dispares a propósito tareas que cambiarían la base de datos, publicarían funciones o cambiarían el almacenamiento.

Completar el primer intento en 3 minutos

Usa solo el comando de instalación recomendado que da la página:

npx skills add supabase/agent-skills

Precondición: esta máquina tiene npx y el directorio de trabajo actual es la raíz del proyecto destino. La ubicación de instalación es el proyecto actual; no lo reescribas como un comando de marketplace o una ruta de copia manual que no aparece en la página.

Punto de confirmación de efectos secundarios: este comando escribe archivos de skills en el proyecto actual. Si el directorio es incorrecto, detente primero. La instalación en sí no cambiará automáticamente tu proyecto de Supabase; después, el Agent podría usar estas skills en cuanto detecte una tarea relevante. Confirma el directorio antes de ejecutar.

Señal de éxito: el comando termina con normalidad y aparecen archivos de skills en el proyecto. Luego haz solo una comprobación: en un Agent compatible, formula una pregunta de solo lectura, por ejemplo cómo entender la conexión actual de Database o Auth, y observa si responde según las skills instaladas. No crees tablas, no despliegues Edge Functions, no cambies Storage ni toques Cron/Queues. Si el Agent se dispone a escribir, detente en el punto de confirmación.

Casos de uso

Caso 1: instalar las skills oficiales en el proyecto actual. En la raíz del proyecto confirmada, ejecuta npx skills add supabase/agent-skills. La evidencia cubre este comando y que ayuda a los desarrolladores a usar Supabase con AI agents. El criterio de finalización termina en la instalación correcta y la aparición de los archivos. No añadas comandos de actualización o desinstalación que no aparecen.

Caso 2: tras instalar, hacer una comprobación de producto de solo lectura. La página indica que las skills cubren cualquier producto de Supabase: Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues; y que tras instalar quedan disponibles automáticamente, usadas cuando el Agent detecta tareas relevantes. El extracto no da un comando slash concreto, así que la primera vez solo pide al Agent una explicación de solo lectura de un producto, por ejemplo cómo entender la configuración existente de Database o Auth. La señal de éxito observable es que el Agent responde con claridad según las skills instaladas, no que ya haya cambiado recursos en la nube. Cron, Queues, Storage y otras caras de escritura están en la lista de productos, pero eso no significa que el primer intento deba operarlas.

Límites de uso

La ruta de instalación principal es solo npx skills add supabase/agent-skills. Los agents listados no son el rango exclusivo compatible. Las skills se activan automáticamente al detectar una tarea relevante, así que evita preguntas que cambiarían datos en vivo. La lista de productos no es una lista de autorización. La desinstalación, los nombres concretos de archivos de skills y los comandos por producto no aparecen en el extracto; lo que no está escrito no puede tomarse como conclusión de seguridad.