Skills
Each skill is a folder with a SKILL.md and sometimes supporting files beside it. Claude Code picks a skill by its description; the ones marked / run only when you call them.
The convention text is written in Portuguese and is shown here as it is in the repository.
Front end
- atomic-designvite, nextjs, react-native, react, djangoOrganização de componentes de interface no Veritas, em todo front-end (Vite, Next.js, React Native e templates Django). Use ao criar um componente novo, decidir onde ele mora, quebrar uma tela em partes, ou quando um componente parecer grande ou repetido demais.
- coresvite, nextjs, react-native, djangoSistema de cores do Veritas em todo front-end (Vite, Next.js, React Native e templates Django), pela regra 60-30-10. Use ao escolher ou mudar uma paleta, criar tokens de cor ou tema, montar modo escuro, definir cor de botão, link, foco, erro ou sucesso, ou quando um texto parecer apagado, a tela parecer colorida demais ou alguém pedir contraste e acessibilidade de cor.
- direcao-de-artevite, nextjs, react-native, djangoDireção de arte do Veritas para página pública — landing page, site institucional, página de produto, portfolio, hero, onboarding de app — em Vite, Next.js, React Native ou templates Django. Use ao criar ou redesenhar uma página que vai ser vista por cliente ou visitante, escrever o texto de uma seção, escolher imagem, ícone, animação ou efeito, ou quando alguém disser que a página está genérica, com cara de template ou "feita por IA".
- django-templatesdjangoFront-end Django com templates renderizados no servidor. Use ao criar ou alterar templates .html de um projeto Django, componentizar uma tela, criar include ou partial, montar formulário no template, começar o front de um projeto ou app Django, ou usar Tailwind, HTMX ou Alpine em Django.
- nextjsnextjs, reactUse ao criar ou editar um projeto Next.js com App Router — Server Components e 'use client', Server Actions, rotas em src/app/, Route Handlers em src/app/api/, layout.tsx e page.tsx, Tailwind CSS e shadcn/ui, React Hook Form com Zod, SWR ou TanStack Query, Prisma ou Drizzle, create-next-app.
- responsividadevite, nextjs, react-native, djangoLayout responsivo do Veritas em todo front-end (Vite, Next.js, React Native e templates Django), do celular de 320px ao monitor largo. Use ao montar ou mudar o layout de uma tela, página ou componente; ao criar menu de celular, tabela, bloco de código, imagem ou formulário que vai aparecer no celular; ao adaptar app para tablet ou paisagem; ou quando aparecer rolagem horizontal, conteúdo cortado, coluna espremida ou algo escondido atrás do notch ou da barra do navegador.
- revisao-de-designvite, nextjs, react-native, djangoRevisão visual do Veritas antes de entregar qualquer tela, em todo front-end (Vite, Next.js, React Native e templates Django). Use ao terminar ou alterar uma tela, página, componente visível ou tema, antes de dizer que está pronto, abrir PR ou mostrar ao cliente; e quando pedirem para revisar UI, design, layout, responsividade, acessibilidade ou modo escuro.
- tipografia-e-espacamentovite, nextjs, react-native, djangoTipografia, espaçamento e medidas de layout do Veritas em todo front-end (Vite, Next.js, React Native e templates Django). Use ao escolher fonte ou par de fontes, definir escala de tamanhos de texto, altura de linha, largura de parágrafo, espaçamento, margem, padding, grid, raio de borda, sombra, breakpoint ou largura de container, ao dimensionar botão ou alvo de toque, ou quando a tela parecer apertada, solta, desalinhada ou com texto pequeno demais.
- vitevite, reactUse ao criar ou revisar código em projetos React + Vite + TypeScript com Tailwind — telas em `src/pages/`, rotas em `src/routes/AppRoutes.tsx`, stores Zustand, services com Axios + TanStack Query, forms React Hook Form + Zod, alias `@/`, `vite.config.ts`, `npm run dev`.
Back end
- bun-hono-apibun-hono-apiConvenções obrigatórias para APIs em Bun + Hono + Drizzle + Zod. Use ao escrever, revisar ou discutir código de API: rotas Hono, services, repositories Drizzle, validação Zod, typed errors, schemas e migrations, auth JWT, testes com bun test. Stack: Bun, Hono, Drizzle, Zod, uuidv7, Biome.
- djangodjango, drfConvenções, camadas e proibições do Veritas para projetos Django e Django REST Framework. Use ao criar, revisar ou alterar views, serializers, services, models, migrations ou autenticação em qualquer projeto Django ou DRF da casa.
- nestjsnestjs, typescriptUse ao criar, editar ou depurar um backend NestJS com TypeScript: app.module.ts, modules, controllers, services, DTOs com class-validator, guards e JwtStrategy (@nestjs/passport, @nestjs/jwt), @nestjs/config, @nestjs/swagger, TypeORM ou Prisma, testes .spec.ts, `nest new`.
Mobile
General
- docs-oficiaisGeneralConsulta a documentação oficial de uma lib, na versão usada pelo projeto, pela CLI do Firecrawl. Use quando houver dúvida sobre API, assinatura ou opção de uma lib; quando a versão do projeto for mais nova que o seu conhecimento; num erro que indique API removida ou alterada (not a function, deprecated, import quebrado); numa migração ou upgrade de versão; ao conferir uma skill do Veritas contra a doc; ou quando pedirem para checar na doc.
- lgpdGeneralProteção de dados pessoais (LGPD) no código e no trabalho do agente. Use ao mexer em código que trata dado pessoal (nome, CPF, e-mail, telefone, endereço, saúde, dado de criança, dado financeiro, senha ou token); ao escrever log, exportação, relatório, CSV, backup ou integração com terceiro; ao criar model ou tabela com dado pessoal; ao encontrar dado exposto, endpoint aberto ou suspeita de vazamento; ou quando pedirem LGPD, anonimização, direitos do titular ou dado de teste.
- mapa-do-codigoGeneralQuando usar o grafo do Graphify e quando usar o Ponytail antes de mexer no código. Use antes de uma mudança em projeto grande ou desconhecido, em perguntas de arquitetura, fluxo de dados ou impacto ("o que quebra se eu mexer aqui?"), quando existir graphify-out/ no repositório, e para decidir o tamanho de uma mudança.
- principiosGeneralPrincípios de engenharia do Veritas, válidos em qualquer stack. Use ao escolher entre duas abordagens, revisar código, decidir se algo deve ser construído, avaliar uma dependência nova, ou quando a solução parecer complexa demais para o problema.
- projeto-existenteGeneralDecide se as convenções do Veritas valem num repositório que já existe ou se a arquitetura dele manda. Use antes da primeira mudança de código num sistema legado, de cliente ou feito por outra equipe, quando o código diverge das skills de stack, ou numa tarefa de refatorar, migrar ou remodelar para uma versão nova.
- pythonpythonUse ao começar ou estruturar um projeto Python — criar um módulo ou pacote novo, definir a estrutura de pastas, escolher entre ruff, pytest e Pydantic, aplicar type hints e tipagem em assinaturas, configurar o pyproject.toml ou gerenciar dependências e ambiente com uv.
Process
Only with /
- ajuda/veritas:ajudaMenu do Veritas — o que existe no banco, como instalar e atualizar, como enviar uma skill nova, como reportar uma que falhou. Só roda quando a pessoa chama.
- ambiente/veritas:ambienteConfere as ferramentas ao redor do Veritas na máquina da pessoa (Veritas, Firecrawl, Headroom, claude-mem, lgpd-skills) e ajusta o que estiver fora do padrão da casa, com confirmação. Só roda quando a pessoa chama.
- atualizar/veritas:atualizarAtualiza o Veritas para a última versão publicada e informa em um relatório único o que deu certo, o que falhou e o que falta. Só roda quando a pessoa chama.
- buscar-skills/veritas:buscar-skillsProcura e instala skills públicas do diretório skills.sh. Só roda quando a pessoa pede — não é convenção da casa, é ferramenta de busca.
- executar-tasks/veritas:executar-tasksPega o próximo card do ClickUp marcado com a etiqueta agente, trabalha nele numa pasta isolada e entrega o PR com o relatório no card. Só roda quando a pessoa chama, ou por tarefa agendada.