Skip to main content
claude tutorialClaude tutorial

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

Ce tutoriel vous montre comment construire des compétences juridiques personnalisées, ajouter des contrôles de sécurité (hooks) et exécuter des workflows multi-agents. Un certain confort technique est requis.

Niveau expert

Compétences développeur recommandées. Durée estimée : 120 minutes.

Contrôle des sources Claude Code 2.1.181

Claude Code 2.1.181 ajoute /config key=value, un paramètre opt-in sandbox.allowAppleEvents pour les Apple Events macOS en sandbox, CLAUDE_CLIENT_PRESENCE_FILE, un meilleur retry lors de coupures API pendant la réflexion, des écritures plus sûres sur lecteurs réseau et dossiers synchronisés cloud, la visibilité des échecs MCP tools/list, ainsi que plusieurs correctifs pour background sessions, subagents, Remote Control, presse-papiers, settings et fuseaux horaires. Le Claude Code Action allowlisté a aussi relevé ses versions par défaut intégrées à Claude Code 2.1.181 et Claude Agent SDK 0.3.181. Pour les dépôts juridiques, re-testez les changements de settings gérés, les permissions d'automatisation macOS, le comportement d'écriture dans les dossiers cloud, les contrôles d'état MCP, la rétention d'historique des background sessions, les limites de profondeur des subagents et les pins de version GitHub Action avant que des workflows non supervisés touchent des dossiers contenant des données client.

Contrôle des sources Claude Code 2.1.183

Claude Code 2.1.183 renforce la sécurité du mode auto en bloquant les commandes destructrices Git et infrastructure non demandées, avertit lorsqu'un modèle demandé est déprécié ou auto-mis à jour, ajoute un paramètre attribution.sessionUrl pour l'attribution des commits et PR, corrige la classification des déclencheurs de tâches planifiées et de webhooks pour qu'ils ne puissent pas approuver des actions en attente, et corrige l'exposition des outils MCP auth-stub en mode headless et SDK. Le Claude Code Action allowlisté a aussi relevé ses versions par défaut intégrées à Claude Code 2.1.183 et Agent SDK 0.3.183. Pour les dépôts juridiques, re-testez les garde-fous de revue des commandes destructrices, les limites d'approbation des webhooks et tâches planifiées, les alertes de retrait de modèle, la politique d'attribution PR, l'exposition de l'authentification MCP et les pins de version avant que des workflows non supervisés touchent des dossiers contenant des données client.

Filtrage des reviews PR par Claude Action

Un commit allowlisté de juin 2026 pour Claude Code Action filtre les pull-request reviews et inline review comments à l'authorized trigger time, comme pour les issue/PR comments et bodies. Pour les legal PR agents, épinglez une version qui inclut ce correctif, traitez les review threads ajoutés après le trigger comme un contexte de référence non fiable, gardez les checkout credentials non persistants et exigez une revue humaine de merge avant que des changements rédigés par un agent n'atteignent des dépôts contenant des données client.

Objectifs d'apprentissage

À la fin de ce tutoriel, vous serez capable de :

  • Comprendre l'architecture de Claude Code (Skills, Hooks, Sub-agents)
  • Construire des compétences juridiques personnalisées pour les workflows de votre cabinet
  • Créer des hooks pour le contrôle qualité et la vérification de conformité
  • Déployer des systèmes multi-agents pour des tâches juridiques complexes

Partie 1 : Comprendre la pile Claude Code

Architecture

Skills : Instructions spécialisées et bonnes pratiques stockées dans des fichiers que Claude lit selon le contexte.

Hooks : Scripts qui s'exécutent à des points spécifiques du cycle de vie d'exécution de Claude.

Sub-agents : Agents autonomes lancés pour gérer des sous-tâches spécifiques.

MCP Servers : Connexions aux outils externes (Tutoriel 07).

Plugins : Bundles packagés de Skills + Hooks + MCP.

Application juridique

ComposantApplication juridique
SkillsEncoder playbooks, procédures de révision, standards de rédaction
HooksAppliquer la vérification de conformité, prévenir les actions non autorisées, audit logging
Sub-agentsParalléliser la révision documentaire, tâches de recherche
PluginsPackager les workflows du cabinet pour distribution

Partie 2 : Construire des compétences juridiques personnalisées

Qu'est-ce qu'un Skill ?

Les Skills sont des instructions spécialisées stockées dans des fichiers que Claude lit selon le contexte. Contrairement aux prompts (ponctuels), les Skills persistent et s'activent automatiquement.

Structure d'un Skill

votre-skill/
├── SKILL.md          # Instructions principales (requis)
├── examples/         # Exemples entrées/sorties
├── templates/        # Modèles de documents
└── resources/       # Matériaux de référence

Créer un Skill de révision contractuelle

Étape 1 : Créer le répertoire du skill (voir section anglaise pour la commande).

Étape 2 : Rédiger SKILL.md avec Purpose, Activation, Instructions, Output format.

Étape 3 : Ajouter des exemples good/bad dans examples/.


Partie 3 : Hooks pour qualité et conformité

Les hooks s'exécutent avant/après des actions. Utilisez-les pour : valider les sorties avant envoi, bloquer les actions non autorisées, logger les accès aux données sensibles.

Note production : Les hooks peuvent bloquer ou modifier un workflow. Testez-les en sandbox avec les permissions, les niveaux d'effort et les serveurs MCP réels avant de les utiliser sur des dossiers clients ou des documents privilégiés.

Qu'est-ce qu'un Hook ?

Scripts exécutés à des points spécifiques : PreToolUse, PostToolUse, SessionStart, UserPromptSubmit, Stop. Voir la section anglaise pour le tableau.

Exemple de hook de conformité juridique

Empêcher les modifications non autorisées sur les dossiers privilégiés. Voir la section anglaise pour le code.

Autres cas d'utilisation de hooks

Vérification des citations, contrôle de confidentialité. Voir la section anglaise pour les exemples.


Partie 4 : Workflows multi-agents juridiques

Comprendre les sous-agents

Claude peut lancer des sous-agents pour des tâches spécifiques : parallélisation (plusieurs documents révisés simultanément), spécialisation (agents dédiés), isolement (contexte séparé).

Exemple : Revue de due diligence parallèle

Plusieurs agents en parallèle (contrats clients, IP, emploi, contentieux). Voir la section anglaise pour le code.

Exemple : Recherche + rédaction

Agent recherche → agent rédaction → agent relecture. Voir la section anglaise pour le flux.


Partie 5 : Empaqueter les Skills en plugins

Structure de plugin

Répertoire avec plugin.json, SKILL.md, .mcp.json, hooks/, commands/, resources/. Voir la section anglaise pour la structure complète.

Manifeste de plugin

Format et schéma du manifeste évoluent. Consultez la référence officielle des plugins.

Installation et distribution

claude --plugin-dir, claude plugin install, claude plugin enable. Voir la section anglaise pour les commandes.


Partie 6 : Considérations de sécurité

Sécurité des skills

Vérification des sources, revue du code des hooks, pas de données client dans les skills, contrôle d'accès.

Protection des données

Hooks UserPromptSubmit pour la sanitisation. Voir la section anglaise pour l'exemple.

Exigences de conformité

  • Skills revus par la sécurité IT
  • Hooks testés en sandbox
  • Audit logging activé
  • Ségrégation des données client vérifiée

À faire maintenant

  • Créer un skill personnalisé pour un processus de révision de votre cabinet
  • Ajouter au moins un hook de sécurité pour conformité ou audit
  • Tester un workflow multi-agent pour le traitement parallèle de documents
  • Documenter votre skill pour votre équipe
  • Envisager l'empaquetage en plugin pour la distribution

Pages famille connexes


Quick Reference: Claude Code Commands

Official Claude Code terminal screenshot showing Claude running in a command-line workflow

Official Claude screenshot from Claude Code. Terminal workflows should be paired with scoped folders, explicit permission modes, and a reviewable diff before legal workflow changes are accepted.

# 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

Sources

Additional Reading