Instalar Supabase Skills no Agent com o comando oficial

Para quem

Este guia é para quem já usa, ou vai usar, um AI Agent para desenvolvimento com Supabase. Oficialmente está escrito como Agent Skills que ajudam desenvolvedores a usar Supabase em AI agents.

Antes de começar, confirme que esta máquina consegue executar npx e que o diretório atual é o projeto onde você quer gravar os arquivos de skills. A página afirma compatibilidade com 18+ AI agents, incluindo Claude Code, GitHub Copilot, Cursor, Cline e muitos outros; isso é uma nota de compatibilidade, não uma lista exclusiva, e não se deve inferir um intervalo de linguagens a partir da lista de produtos.

Depois da instalação, as skills ficam disponíveis automaticamente, e o Agent as usa quando detecta tarefas relevantes. Na primeira tentativa, não dispare de propósito tarefas que mudariam o banco, publicariam funções ou alterariam o armazenamento.

Concluir a primeira tentativa em 3 minutos

Use apenas o comando de instalação recomendado indicado na página:

npx skills add supabase/agent-skills

Pré-condição: esta máquina tem npx, e o diretório de trabalho atual é a raiz do projeto de destino. O local de instalação é o projeto atual; não reescreva isso como comando de marketplace ou caminho de cópia manual que não aparece na página.

Ponto de confirmação de efeitos colaterais: este comando grava arquivos de skills no projeto atual. Se o diretório estiver errado, pare primeiro. A instalação em si não altera automaticamente o seu projeto Supabase; depois, porém, o Agent pode usar essas skills assim que detectar uma tarefa relevante. Confirme o diretório antes de executar.

Sinal de sucesso: o comando termina normalmente e arquivos de skills aparecem no projeto. Em seguida, faça só uma conferência: num Agent compatível, faça uma pergunta somente leitura, por exemplo como entender a conexão atual de Database ou Auth, e veja se a resposta segue as skills instaladas. Não crie tabelas, não implante Edge Functions, não altere Storage nem mexa em Cron/Queues. Se o Agent for executar uma escrita, pare no ponto de confirmação.

Casos de uso

Caso 1: instalar as skills oficiais no projeto atual. Na raiz do projeto confirmada, execute npx skills add supabase/agent-skills. A evidência cobre este comando e o fato de ajudar desenvolvedores a usar Supabase com AI agents. O critério de conclusão para na instalação bem-sucedida e na aparição dos arquivos. Não acrescente comandos de atualização ou desinstalação que não aparecem.

Caso 2: depois de instalar, fazer uma conferência de produto somente leitura. A página afirma que as skills cobrem qualquer produto Supabase: Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues; e que após a instalação ficam automaticamente disponíveis, usadas quando o Agent detecta tarefas relevantes. O trecho não dá um comando slash específico, então na primeira vez pergunte ao Agent só uma explicação somente leitura de um produto, por exemplo como entender a configuração existente de Database ou Auth. O sinal de sucesso observável é o Agent responder claramente com as skills instaladas, não ter já alterado recursos na nuvem. Cron, Queues, Storage e outras faces de escrita estão na lista de produtos, mas isso não significa que a primeira tentativa deva operá-las.

Limites de uso

O caminho principal de instalação é apenas npx skills add supabase/agent-skills. Os agents listados não são o intervalo exclusivo suportado. As skills são ativadas automaticamente quando uma tarefa relevante é detectada, então evite perguntas que mudariam dados online. A lista de produtos não é uma lista de autorização. Desinstalação, nomes específicos de arquivos de skills e comandos por produto não aparecem no trecho; o que não está escrito não pode ser tratado como conclusão de segurança.