Por que uma skill
Seu time pode já manter as regras de segurança como uma skill de agente, para assistentes de código. Um agente personalizado pode seguir a mesma skill no code review: ele abre a skill quando a mudança pede, lê os arquivos de referência e cita a regra que cada apontamento aplica. Quando a skill muda na branch principal, o agente segue a versão nova sem mexer nas configurações. O exemplo é uma API de agendamento multi-tenant em que toda consulta precisa ficar restrita ao workspace de quem chama.Passo 1 — A skill no repositório
.claude/skills/tenant-isolation/SKILL.md
.claude/skills/tenant-isolation/references/tenant-tables.md
name precisam ser iguais, e description é obrigatório.
Passo 2 — Importe como agente
1
Abra as configurações do repositório
Escolha o repositório no seletor de escopo e vá em What to review → Custom agents → New agent.
2
Import from repository
A aba lista as skills encontradas na branch padrão. Clique em tenant-isolation.
3
Confira o resultado
O agente é criado desligado, com o nome Tenant isolation reviewer, a skill vinculada e estas instruções:
Passo 3 — Afine as instruções
Mantenha a referência à skill e acrescente que prova um apontamento precisa:Instructions
Passo 4 — Opcional: um plugin
Se o seu gerenciador de tarefas está instalado como plugin, ligue-o em Tools → Plugins. Só ferramentas de leitura são oferecidas. Quando a descrição do pull request tem o link de um ticket, o agente pode ler o ticket e conferir a mudança contra o que ele pede.Passo 5 — Comentários
Clique em Save.
Passo 6 — Try it
Rode o Try it num pull request que adiciona um endpoint. Confira:- Skills opened mostra
.claude/skills/tenant-isolatione, quando o agente precisou,references/tenant-tables.md. - Os apontamentos mantidos citam uma regra da skill:
- Os apontamentos descartados mostram o motivo. Uma observação geral de segurança que a skill não cobre é descartada como fora do foco do agente, que é o que você quer aqui.
@kody -v tenant-isolation-reviewer.
Checklist
- O
SKILL.mdtemnameigual ao da pasta e umadescription - Os arquivos de referência ficam no máximo uma pasta abaixo da skill
- As instruções dizem que prova um apontamento precisa
- A severidade mínima combina com o quanto o agente deve falar
- Testado num pull request com uma falha conhecida