Completar auth e clientes de Edge Functions com supabase/server

Install

npx skills add supabase/server

Para quem

Este skill serve para quem escreve Edge Functions ou APIs e não quer reescrever à mão auth, criação de cliente e CORS. Oficialmente é um invólucro no servidor: auth, criação de cliente e injeção de contexto ficam com ele, você escreve a lógica de negócio. Também serve para quem já usa um agente de código de IA — o texto-fonte diz que dá para instalar o skill em agentes como Claude Code e Cursor.

Não serve para quem só faz páginas de navegador e nunca toca numa entrada de servidor. O pedido precisa entrar em Edge Functions ou numa API para criação de cliente e auth ficarem automaticamente limitados ao pedido de entrada. Se ainda não há um agente que instale skills, confirme que consegue executar o comando oficial de instalação antes de continuar. Uma checagem somente leitura também vale: peça ao agente para explicar como envolver fetch com uma linha de configuração e não mude funções de produção ainda. O repositório oficial é

https://github.com/supabase/server

Siga os comandos já escritos nessa página.

Primeira tentativa em 3 minutos

Siga só o único caminho de instalação de skill que o texto oficial escreve.

Pré-requisito: esta máquina consegue executar npx e você usa um dos agentes de código de IA nomeados no texto, por exemplo Claude Code ou Cursor. Abrir o projeto onde você costuma escrever Edge Functions ou APIs basta. Esta etapa é uma checagem de explicação; não mude código ao vivo nem envie pedidos para fora.

Local de instalação: num terminal na raiz do projeto, execute:

npx skills add supabase/server

Esse comando instala o skill no agente atual. O texto oficial também diz: em Deno ou Supabase Edge Functions você pode não instalar pacote e importar direto de npm:@supabase/server.

Dispare uma tarefa de baixo risco: peça ao agente que já tem o skill para listar em texto «como envolver fetch com withSupabase para a função de tratamento só entrar depois da auth passar», e escrever a sentença de importação. Não grave arquivos, não chame interfaces externas, não faça deploy.

Sinal de sucesso: o agente consegue repetir que após uma importação e uma linha de configuração a auth é verificada, o cliente está pronto, o CORS é tratado e a função de tratamento só corre após auth bem-sucedida; e entrega import { withSupabase } from "npm:@supabase/server". Se inventar outro comando de instalação, volte ao comando oficial acima e tente de novo.

Casos de uso

Caso 1: colocar o invólucro oficial na entrada fetch de uma Edge Function ou API existente. O caminho principal do texto é envolver fetch com withSupabase: após uma importação e uma linha de configuração, a auth já foi verificada, o cliente está pronto, o CORS tratado, e a função de tratamento só corre quando a auth passa. Você pode primeiro pedir ao agente para marcar a entrada a mudar e o código de negócio a manter, e agir depois da confirmação. Se o texto não tiver um exemplo de função completo, pare em «a entrada está envolvida e auth falha não entra na função de tratamento»; não invente tabela de rotas nem esquema de segredos.

Caso 2: importar direto em Deno ou Supabase Edge Functions em vez de instalar um pacote primeiro. O texto diz que esse ambiente pode pular a instalação e usar import { withSupabase } from "npm:@supabase/server" direto. Serve para quem já escreve funções de tratamento nesse runtime e só quer conferir o caminho de importação. Confirme primeiro que a importação vale para o runtime do arquivo atual; se o projeto não for Deno nem Edge Functions, o texto para aqui — não estenda a um runtime sem nome.

Limites de uso

O texto cobre só a entrada de servidor: criação de cliente e auth ficam automaticamente limitados aos pedidos de entrada que entram em Edge Functions e APIs. Não prova uso em páginas de navegador, tarefas agendadas de fundo ou hospedagens sem nome.

Só um comando de instalação de skill está escrito: npx skills add supabase/server. Não coloque um instalador que não aparece no caminho principal. Claude Code, Cursor e outros são um conjunto de exemplos, não os únicos dois agentes suportados.

No uso do pacote, o texto dá a importação direta para Deno / Supabase Edge Functions e envolver fetch com withSupabase. Se você não vir nomes de variáveis de ambiente, chaves detalhadas de CORS ou política de nova tentativa, não invente. A função de tratamento só corre após auth bem-sucedida; qual código de status volta na falha não está escrito. A página oficial é