> ## Documentation Index > Fetch the complete documentation index at: https://supastack.dev/llms.txt > Use this file to discover all available pages before exploring further. > For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt # Skills Instruções prontas que ensinam o teu agente de código a fazer as tarefas comuns do supastack da forma que o kit espera. ## O que são as skills O supastack inclui Agent Skills: instruções curtas e focadas em tarefas que o teu agente de código carrega quando um trabalho corresponde. Em vez de adivinhar as convenções do kit em cada prompt, o agente segue os mesmos passos para funcionalidades, pagamentos, alterações de base de dados e testes. As skills seguem o formato aberto Agent Skills, por isso funcionam no Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI e outros agentes compatíveis. ## Onde ficam as skills As skills ficam em `.agents/skills/`, uma pasta por skill com um `SKILL.md` dentro. Cópias idênticas estão em `.claude/skills/` para o Claude Code. ## Que agentes as leem Codex, Cursor, GitHub Copilot, Gemini CLI e OpenCode leem `.agents/skills/`. O Claude Code lê `.claude/skills/`. O teu agente escolhe uma skill automaticamente quando o pedido corresponde à descrição — ou podes nomeá-la: «use the `database-schema-change` skill». ## Que repositórios as incluem O repositório all-platforms inclui todas as skills. Os repositórios web, mobile e desktop incluem as skills que lhes são aplicáveis; as skills de testes end-to-end e de CI só são enviadas com o repositório all-platforms. ## Configuração e ambiente Skills para pôr o kit a correr, fazer deploy e configurar. - **Configuração do ambiente local** (`local-environment-setup`) — ao montar ou reparar o ambiente local: primeiro clone, .env em falta ou quebrado, Postgres, migrações ou portas. - **Deploy e variáveis de ambiente** (`deploy-and-env-vars`) — ao fazer deploy, escolher um destino de hosting ou adicionar/alterar uma variável de ambiente. - **Adicionar uma dependência** (`adding-a-dependency`) — ao adicionar, atualizar, mover ou remover uma dependência npm, ou quando o CI falha a verificação de licenças ou auditoria. - **Atualizar a partir de upstream** (`upgrading-from-upstream`) — ao trazer uma release mais recente do supastack para um produto construído sobre ela. ## Construir funcionalidades Skills para adicionar superfície de produto em cada plataforma. - **Adicionar uma funcionalidade web** (`add-a-web-feature`) — para uma página ou secção de produto com dados, server actions, navegação e testes próprios. - **Adicionar um endpoint de API** (`add-an-api-endpoint`) — ao adicionar ou alterar um endpoint público /api/v1, a sua documentação OpenAPI ou os scopes de API key. - **Adicionar um componente de UI** (`add-a-ui-component`) — para uma secção, bloco, controlo de formulário ou componente reutilizável que siga as regras de estilo do kit. - **Mudar o tema ou o estilo** (`change-the-theme-or-style`) — ao mudar o aspeto do produto: estilo de design, pack de cores, densidade, raio, fonte ou layout. - **Adicionar página de marketing ou post** (`add-a-marketing-page-or-blog-post`) — ao adicionar ou editar uma página pública, página de preços, página legal, post de blogue ou guia de documentação. - **Adicionar um ecrã mobile** (`add-a-mobile-screen`) — ao adicionar ou alterar um ecrã na app mobile Expo. - **Adicionar uma capacidade de desktop** (`add-a-desktop-capability`) — ao alterar a app desktop Tauri: janela, tray, atalho global ou atualizações automáticas. - **Adicionar uma notificação** (`add-a-notification`) — para uma notificação in-app, notificação push ou item de digest. ## Auth e pagamentos Skills para sign-in, faturação e planos. - **Adicionar um método de auth** (`add-an-auth-method`) — ao mudar o sign-in: providers sociais, magic links, códigos por email, passkeys ou dois fatores. - **Adicionar um provider de pagamento** (`add-a-payment-provider`) — ao ativar um provider de faturação ou escrever um novo adapter com checkout, portal de cliente e webhooks. - **Mudar planos e preços** (`change-plans-and-pricing`) — ao adicionar, renomear ou mudar o preço de um plano: preços, trials, seats, entitlements, limites de uso ou créditos. ## Dados e integrações Skills para o schema, IA, jobs, email, storage e traduções. - **Alteração de schema da base de dados** (`database-schema-change`) — ao adicionar ou alterar uma tabela, coluna, índice ou relação e gerar a migração. - **Adicionar uma funcionalidade de IA** (`add-an-ai-feature`) — para uma chamada de modelo, ferramenta de chat ou agente, tarefa de IA durável, orçamentos ou bring-your-own-key. - **Adicionar um job em segundo plano** (`add-a-background-job`) — para trabalho que corre depois de um pedido, em timer ou por workspace. - **Adicionar ou editar um email** (`add-or-edit-an-email`) — ao adicionar ou alterar um email transacional ou mudar o provider que o entrega. - **Usar armazenamento de ficheiros** (`use-file-storage`) — para uploads ou ficheiros guardados como avatares, logótipos ou anexos. - **Adicionar traduções** (`add-translations`) — ao adicionar ou alterar texto visível ao utilizador, traduzi-lo ou adicionar um locale. ## Qualidade e lançamento Skills para testes, verificação, reviews e CI. - **Escrever testes unitários** (`writing-unit-tests`) — ao escrever ou corrigir testes unitários ou de integração Vitest. - **Escrever testes e2e** (`writing-e2e-tests`) — ao adicionar ou corrigir testes end-to-end Playwright, localmente ou em CI. - **Verificar alterações** (`verify-changes`) — antes de um handoff, commit ou pull request, para escolher e correr as verificações certas. - **Depurar um run de CI falhado** (`debugging-a-failing-ci-run`) — quando um run de GitHub Actions falha e precisas de encontrar e corrigir a causa. - **Rever uma PR** (`reviewing-a-pr`) — ao rever uma pull request ou diff quanto a correção, isolamento de workspace e convenções. ## Adicionar as tuas Adiciona uma pasta cujo nome corresponda ao `name` no frontmatter, com um `name` e uma `description` que dizem quando a usar. Copia-a também para `.claude/skills/` para que todos os agentes a encontrem. ## Seguinte [Desenvolva com um agente de codificação](https://supastack.dev/pt/docs/web/agents.md)