Skills (Claude Code)

O que são Skills?

Skills são workflows guiados passo-a-passo instalados no Claude Code que automatizam as tarefas de desenvolvimento mais complexas e repetíveis do ExzosSphere.

Ao contrário das Rules — que definem padrões passivamente —, as Skills conduzem ativamente o agente por uma sequência de etapas com validações e pontos de aprovação humana.

Skills disponíveis

Skills vs Rules

Como invocar uma skill

Mencione naturalmente em qualquer conversa com Alexys no Claude Code:

"criar feature de webhooks"          → exzossphere-feature-dev
"nova API para relatórios"           → exzossphere-api-route
"adicionar modelo Webhook ao banco"  → exzossphere-db-schema
"criar página de webhooks no app"    → exzossphere-dashboard-feature
"configurar meu ambiente"            → exzossphere-setup-env

Detalhes de cada skill

exzossphere-feature-dev — Spec-Driven Development

Conduz as 5 fases do SDD do ExzosSphere:

1. Research — Analisa o codebase, encontra padrões similares
2. PROPOSAL.md — Cria a proposta com estimativas de tempo → aguarda aprovação
3. TASKS.md — Detalha as tarefas por fase → aguarda aprovação
4. Implementação — Executa em ordem: DB → API → UI → Testes
5. FEATURE_CHECKLIST.md + Docs — Valida cobertura e gera documentação MDX

exzossphere-api-route — ExzosAtom Route Scaffolding

Gera todos os arquivos de uma rota ExzosAtom em sequência:

{feature}.interface.ts   ← Zod schemas de input/output
{feature}.controller.ts  ← Actions com AuthFeatureProcedure
igniter.router.ts        ← Registro do controller

Garante os 5 padrões obrigatórios:

• AuthFeatureProcedure() em toda action autenticada
• getSession() dentro do handler
• Filtro por organizationId em toda query
• Roles corretas (owner/admin para escrita, todos para leitura)
• npm run typecheck ao final

exzossphere-db-schema — Prisma Workflow

# Sequência executada automaticamente
npx prisma format
npx prisma generate
npx prisma migrate dev --name {descricao}

Inclui preview do bloco gerado com aprovação antes de editar o arquivo.

Template padrão para modelos multi-tenant:

model {Model} {
  id             String   @id @default(cuid())
  createdAt      DateTime @default(now())
  updatedAt      DateTime @updatedAt
  organizationId String
  organization   Organization @relation(...)
  @@index([organizationId])
}

exzossphere-dashboard-feature — DDD Feature Scaffold

Cria a estrutura completa:

src/features/{feature}/
├── {feature}.interface.ts
├── {feature}.router.ts
└── presentation/
    ├── {feature}-list.tsx
    ├── {feature}-form.tsx
    └── {feature}-delete-dialog.tsx

src/app/(dashboard)/app/{feature}/
└── page.tsx

Também integra o item no sidebar de navegação.

exzossphere-setup-env — Environment Setup

8 passos do setup completo:

1. Verificar Node.js 22+, Docker, Git
2. npm install --legacy-peer-deps
3. Configurar .env interativamente
4. npm run docker:up + health check
5. npm run db:generate + db:migrate:dev
6. npm run auth:migrate
7. npm run dev + verificação em localhost:3000
8. Registrar em PROJECT_MEMORY.md

Estrutura do diretório .skills/

.skills/
├── README.md                    ← Índice e instruções
├── feature-dev/
│   └── SKILL.md
├── api-route/
│   └── SKILL.md
├── db-schema/
│   └── SKILL.md
├── dashboard-feature/
│   └── SKILL.md
└── setup-env/
    └── SKILL.md

Criar skills personalizadas

Para criar uma nova skill específica do seu produto:

1. Crie um diretório em .skills/{nome-da-skill}/
2. Crie SKILL.md com frontmatter name e description
3. Instale no Claude Code via .skill file ou copie manualmente

Consulte a skill oss-rebrand como exemplo de skill genérica de projeto.