Tutorial 09: Custom Legal Skills, Hooks & Agents

Build custom skills for your firm's workflows, create compliance hooks, and deploy multi-agent systems for complex legal tasks.

What You'll Learn

Este tutorial mostra como construir skills jurídicos personalizados, adicionar verificações de segurança (hooks) e executar fluxos multi-agente. É necessário certo conforto técnico.

Nível expert

Habilidades de desenvolvedor recomendadas. Tempo estimado: 120 minutos.

Objetivos de aprendizagem

Ao final deste tutorial, você poderá:

Compreender a arquitetura do Claude Code (Skills, Hooks, Sub-agents)
Construir skills jurídicos personalizados para os fluxos do seu escritório
Criar hooks para controle de qualidade e verificação de conformidade
Implantar sistemas multi-agente para tarefas jurídicas complexas

Parte 1: Entendendo a stack Claude Code

Visão geral da arquitetura

Skills: Instruções especializadas e melhores práticas armazenadas em arquivos que o Claude lê com base no contexto.

Hooks: Scripts que executam em pontos específicos do ciclo de vida de execução do Claude.

Sub-agents: Agentes autônomos iniciados para lidar com subtarefas específicas.

Servidores MCP: Conexões com ferramentas externas (veja Tutorial 07).

Plugins: Pacotes de Skills + Hooks + MCP.

Aplicação jurídica

Componente	Aplicação jurídica
Skills	Codificar playbooks, procedimentos de revisão e padrões de redação
Hooks	Aplicar conformidade, impedir ações não autorizadas, audit logging
Sub-agents	Paralelizar revisão de documentos e tarefas de pesquisa
Plugins	Empacotar fluxos do escritório para distribuição

Parte 2: Construindo skills jurídicos personalizados

O que são Skills?

Skills são instruções especializadas armazenadas em arquivos que o Claude lê com base no contexto. Ao contrário de prompts (uma vez), os Skills persistem e ativam automaticamente.

Estrutura de arquivo Skill

seu-skill/
├── SKILL.md          # Instruções principais (obrigatório)
├── examples/         # Exemplos de inputs/outputs
├── templates/        # Modelos de documento
└── resources/        # Material de referência

Criar um skill de revisão de contratos

Etapa 1: Crie o diretório do skill (veja a seção em inglês para o comando).

Etapa 2: Escreva o SKILL.md com Purpose, Activation, Instructions e Output format.

Etapa 3: Adicione exemplos good/bad em examples/.

Parte 3: Hooks para qualidade e conformidade

Os hooks executam antes/depois de ações. Use-os para: validar saídas antes do envio, bloquear ações não autorizadas, registrar acessos a dados sensíveis.

O que são Hooks?

Scripts que executam em pontos específicos: PreToolUse, PostToolUse, SessionStart, UserPromptSubmit, Stop. Veja a seção em inglês para a tabela.

Exemplo de hook de conformidade jurídica

Impedir alterações não autorizadas em pastas privilegiadas. Veja a seção em inglês para o código.

Outros casos de uso de hooks

Verificação de citações, controle de confidencialidade. Veja a seção em inglês para os exemplos.

Parte 4: Fluxos multi-agente jurídicos

Entender os sub-agents

O Claude pode iniciar sub-agents para tarefas específicas: paralelização (vários documentos revisados simultaneamente), especialização (agentes dedicados), isolamento (contexto separado).

Exemplo: Revisão de due diligence paralela

Vários agentes em paralelo (contratos de clientes, IP, emprego, litígios). Veja a seção em inglês para o código.

Exemplo: Pesquisa + redação

Agente pesquisa → agente redação → agente revisão. Veja a seção em inglês para o fluxo.

Parte 5: Empacotar Skills em plugins

Estrutura de plugin

Diretório com plugin.json, SKILL.md, .mcp.json, hooks/, commands/, resources/. Veja a seção em inglês para a estrutura completa.

Manifesto do plugin

O formato e o esquema do manifesto evoluem. Consulte a referência oficial de plugins.

Instalação e distribuição

claude --plugin-dir, claude plugin install, claude plugin enable. Veja a seção em inglês para os comandos.

Parte 6: Considerações de segurança

Segurança de skills

Verificação de fontes, revisão do código dos hooks, não incluir dados de clientes nos skills, controle de acesso.

Proteção de dados

Hooks UserPromptSubmit para sanitização. Veja a seção em inglês para o exemplo.

Requisitos de conformidade

Skills revisados pela segurança de TI
Hooks testados em sandbox
Audit logging ativado
Segregação de dados de clientes verificada

Faça agora

Criar um skill personalizado para um processo de revisão do seu escritório
Adicionar pelo menos um hook de segurança para conformidade ou auditoria
Testar um fluxo multi-agente para processamento paralelo de documentos
Documentar seu skill para sua equipe
Considerar empacotar como plugin para distribuição

# Skills (filesystem locations)
~/.claude/skills/           # Personal custom skills
.claude/skills/             # Project custom skills
 
# Hooks
/hooks                      # Open hooks manager in Claude Code
 
# Plugin hooks
${CLAUDE_PLUGIN_ROOT}/hooks/hooks.json
 
# Debugging
claude --help