Skills

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.