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

Questo tutorial mostra come costruire competenze giuridiche personalizzate, aggiungere controlli di sicurezza (hooks) ed eseguire flussi multi-agente. È richiesta una certa dimestichezza tecnica.

Livello esperto

Competenze da sviluppatore consigliate. Tempo stimato: 120 minuti.

Obiettivi di apprendimento

Al termine di questo tutorial potrai:

Comprendere l'architettura di Claude Code (Skills, Hooks, Sub-agents)
Costruire skill giuridici personalizzati per i flussi del tuo studio
Creare hook per controllo qualità e conformità
Implementare sistemi multi-agente per attività giuridiche complesse

Parte 1: Comprendere lo stack Claude Code

Panoramica dell'architettura

Skills: Istruzioni specializzate e best practice memorizzate in file che Claude legge in base al contesto.

Hooks: Script che si eseguono in punti specifici del ciclo di vita di Claude.

Sub-agents: Agenti autonomi avviati per gestire sottotask specifici.

Server MCP: Connessioni a strumenti esterni (vedi Tutorial 07).

Plugins: Pacchetti di Skills + Hooks + MCP.

Applicazione legale

Componente	Applicazione legale
Skills	Codificare playbook, procedure di revisione, standard di redazione
Hooks	Applicare conformità, prevenire azioni non autorizzate, audit logging
Sub-agents	Parallelizzare revisione documentale, task di ricerca
Plugins	Impacchettare flussi dello studio per distribuzione

Parte 2: Costruire skill legali personalizzati

Cosa sono gli Skills?

Gli Skills sono istruzioni specializzate memorizzate in file che Claude legge in base al contesto. A differenza dei prompt (una tantum), gli Skills persistono e si attivano automaticamente.

Struttura file Skill

tuo-skill/
├── SKILL.md          # Istruzioni principali (richiesto)
├── examples/         # Esempi input/output
├── templates/        # Modelli di documenti
└── resources/        # Materiale di riferimento

Creare uno skill di revisione contrattuale

Passo 1: Creare la directory dello skill (vedi sezione in inglese per il comando).

Passo 2: Scrivere SKILL.md con Purpose, Activation, Instructions, Output format.

Passo 3: Aggiungere esempi good/bad in examples/.

Parte 3: Hooks per qualità e conformità

Gli hook si eseguono prima/dopo le azioni. Usateli per: validare output prima dell'invio, bloccare azioni non autorizzate, registrare accessi a dati sensibili.

Cosa sono gli Hook?

Script che si eseguono in punti specifici: PreToolUse, PostToolUse, SessionStart, UserPromptSubmit, Stop. Vedi sezione in inglese per la tabella.

Esempio di hook di conformità legale

Impedire modifiche non autorizzate alle cartelle privilegiate. Vedi sezione in inglese per il codice.

Altri casi d'uso degli hook

Verifica citazioni, controllo riservatezza. Vedi sezione in inglese per gli esempi.

Parte 4: Flussi multi-agente legali

Comprendere i sub-agents

Claude può avviare sub-agents per task specifici: parallelizzazione (più documenti revisionati simultaneamente), specializzazione (agenti dedicati), isolamento (contesto separato).

Esempio: Revisione due diligence parallela

Più agenti in parallelo (contratti clienti, IP, lavoro, contenzioso). Vedi sezione in inglese per il codice.

Esempio: Ricerca + bozza

Agente ricerca → agente bozza → agente revisione. Vedi sezione in inglese per il flusso.

Parte 5: Impacchettare Skills in plugins

Struttura plugin

Directory con plugin.json, SKILL.md, .mcp.json, hooks/, commands/, resources/. Vedi sezione in inglese per la struttura completa.

Manifest plugin

Formato e schema del manifest evolvono. Consultare la referenza ufficiale dei plugin.

Installazione e distribuzione

claude --plugin-dir, claude plugin install, claude plugin enable. Vedi sezione in inglese per i comandi.

Parte 6: Considerazioni di sicurezza

Sicurezza degli skills

Verifica delle fonti, revisione del codice degli hook, nessun dato cliente nei file skill, controllo accessi.

Protezione dati

Hooks UserPromptSubmit per sanitizzazione. Vedi sezione in inglese per l'esempio.

Requisiti di conformità

Skills revisionati da sicurezza IT
Hooks testati in sandbox
Audit logging attivato
Segregazione dati clienti verificata

Fai ora

Creare uno skill personalizzato per un processo di revisione del tuo studio
Aggiungere almeno un controllo di sicurezza (hook) per conformità o audit
Testare un flusso multi-agente per elaborazione parallela di documenti
Documentare lo skill per il tuo team
Considerare l'impacchettamento come plugin per la distribuzione

# 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