Skills são como o Octopus diz ao agent o que fazer e como fazer
com disciplina. Cada skill é um pequeno arquivo Markdown com
frontmatter que dispara o engajamento conforme a intenção do
usuário — uma descrição que diz “use quando X”, triggers:
opcionais para auto-engajamento em padrões específicos de arquivo,
e um corpo que conduz o agent pela sequência correta de passos.
Por que skills, e não só rules
Rules descrevem como é um bom código (coding style, security,
patterns) — são carregadas em toda conversa como contexto
permanente. Skills descrevem como executar uma tarefa — são
carregadas sob demanda quando a intenção do usuário casa com a
descrição da skill.
Essa divisão mantém o contexto ativo enxuto: uma rule sobre
Conventional Commits está sempre carregada, mas toda a disciplina
de PR-feedback só carrega quando você está de fato recebendo
feedback em um PR. Skills são a camada “engaja quando preciso”.
Granularidade
Conforme a rule do docs-site, apenas skills com decisões de design
não-triviais ganham uma página de detalhe. Padrões específicos de
stack, wrappers finos e utilitários de uma única função ficam
listados nas tabelas de visão geral, sem página própria.
Audits
Gates de auditoria pré-merge. Cada um roda read-only e produz um
relatório por severidade (⛔ block / ⚠ warn / ℹ info). O
compositor audit-all executa os relevantes em paralelo.
| Skill | Audita | Detalhe |
|---|
audit-all | Compositor para os quatro audits abaixo — descoberta de arquivos compartilhada, execução paralela, relatório consolidado. | → |
audit-security | Segredos hardcoded, riscos de injection, lacunas de auth em rotas públicas, CVEs de dependências. | → |
audit-money | Tipos monetários, arredondamento, testes com centavos não-redondos, consistência de env-vars, idempotência de pagamentos, verificação de assinatura de webhooks, acoplamento de fee-disclosure. | → |
audit-tenant | Enforcement de escopo de dados multi-tenant — filtros de query, raw SQL, configs de novas entities, ownership em controllers, endpoints administrativos. | → |
audit-config | Atualidade da configuração do agent — premissas específicas de modelo, datas obsoletas, skills fantasmas, paths depreciados. | → |
audit-grounding | Divergência signal-only da fonte de verdade — convenções inventadas, fatos de domínio sem suporte que o formatter não enxerga. | → |
audit-fleet | Adoção + drift cross-repo — config de cada repo vs o alvo declarado (baseline + perfil de stack + tier de adoção) do fleet.yml. Signal-only; alimenta o fleet-bootstrap. | → |
audit-contracts | Drift de contrato entre frontend/backend — endpoints, DTOs, enums, status codes, regras de auth, parâmetros. | → |
Workflows de implementação
| Skill | Engaja quando | Detalhe |
|---|
implement | Qualquer tarefa de edição de código — default em toda implementação. | → |
debug | O usuário reporta um bug, falha de teste ou comportamento inesperado. | → |
prototype | O usuário quer destravar um design antes de assumir compromisso — código descartável a serviço de decisões. | → |
test-tdd | Implementando uma nova feature com loop explícito de red/green/refactor. | — |
test-e2e | Adicionando um teste end-to-end que bate em serviços reais. | — |
test-component | Adicionando um teste em nível de componente (RTL) — comportamento sobre implementação. | — |
backend-patterns | Trabalho de implementação no backend — camadas conscientes da stack. | — |
frontend-patterns | Trabalho de implementação no frontend — design de componente, estado, acessibilidade. | — |
Refactoring
| Skill | Engaja quando | Detalhe |
|---|
refactor-deepen | O codebase tem módulos rasos que deveriam ser consolidados. | → |
Ciclo de vida de docs
A cadeia completa RFC → Spec → ADR → Knowledge. Cada etapa é uma
skill que o comando correspondente invoca.
| Skill | Saída | Detalhe |
|---|
doc-lifecycle | Roteia entre RFC / Spec / ADR / Knowledge conforme escopo e risco — a skill de entrada para trabalho de documentação. | → |
doc-adr | Um novo Architecture Decision Record em docs/adr/. | → |
doc-plan | Um plan de implementação em estilo TDD, fatiado em pedaços pequenos, a partir de uma spec aprovada. | → |
doc-subcontext | CLAUDE.md por módulo para monorepos — herda do parent. | → |
doc-api | Referência de API voltada ao integrador + OpenAPI mantida fiel ao código — valide o contrato ou regenere os docs. | → |
doc-align | Reconcilia o drift entre código e docs. | — |
doc-prd | PRD publicado no issue tracker do projeto. | — |
Conhecimento & planejamento
| Skill | Engaja quando | Detalhe |
|---|
continuous-learning | Capturando insights que valem a pena guardar entre sessões; o team mode agrega feedback recorrente de review pela frota em candidatos a regra. | → |
standards | Self-serve “qual é o nosso padrão para X, e por quê” — respondido a partir de ADRs, rules, CONTEXT.md, knowledge; roteia para autoria quando não acha. | — |
definition-of-done | A Definition of Done do time como artefato versionado — crie/atualize, ou valide um diff contra ela. Integrada ao codereview, signal-only. | → |
onboarding | Rampa um novo engenheiro nos standards, arquitetura e workflow de um repo — um ramp escopado e efêmero que apresenta o deck do map-system. | → |
plan-backlog | Auditando o roadmap e os plans em busca de itens obsoletos, órfãos e links quebrados. | → |
context-budget | A conversa está pesada em tokens e precisa de poda. | — |
context-handoff | Passando a sessão atual para outro agent. | — |
map-system | Mapeando um repo — uma orientação textual rápida, ou um deck HTML autocontido e temado do repo inteiro (o default). | → |
fleet-bootstrap | Converge 6+ repos num padrão em camadas (baseline + perfil de stack + tier de adoção) a partir de um fleet.yml — multi-stack e legado em primeiro plano; dry-run, não-destrutivo. | → |
interview | Stress-testando um plan via grilling. | — |
council | Pressionando uma decisão de alto risco a partir de cinco lentes, com peer-review anônimo e veredito do chairman. | → |
triage-issues | Roteando issues recebidas por uma máquina de estados. | — |
Lançamentos
| Skill | Saída | Detalhe |
|---|
launch-feature | Kit de lançamento multi-canal a partir de uma feature concluída (RM / spec / PR). | → |
launch-release | Kit temático de anúncio de release para usuários atuais — landing page, e-mail, Slack, Discord, banner, thread no X, deck. | → |
| Skill | Engaja quando | Detalhe |
|---|
scaffold-skill | Criando uma nova skill de ponta a ponta. | Coberto em /commands/scaffold-skill/ |
compress-skill | Encolhendo um SKILL.md sem mudar a semântica. | — |
delegate | Roteando uma tarefa para uma role específica. | — |
Padrões de stack
| Skill | O que adiciona |
|---|
dotnet | Orientação específica da stack .NET / C# — async/await, EF Core, naming, estrutura de arquivos. |
Recebendo code review
| Skill | Engaja quando | Detalhe |
|---|
respond-to-review | Recebendo feedback em um PR — a triagem verify / ask-for-evidence / disagree-with-reasoning. | Coberto em /commands/pr-comments/ |
Fonte: skills/
