Skip to main content
Legalai.guide
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

Este tutorial muestra cómo construir competencias jurídicas personalizadas, añadir controles de seguridad (hooks) y ejecutar flujos multi-agente. Se requiere cierta soltura técnica.

Nivel experto

Se recomiendan competencias de desarrollador. Duración estimada: 120 minutos.

Verificación de fuentes de Claude Code 2.1.181

Claude Code 2.1.181 añade /config key=value, una opción opt-in sandbox.allowAppleEvents para Apple Events de macOS en sandbox, CLAUDE_CLIENT_PRESENCE_FILE, mejor retry cuando se cae la conexión API durante el razonamiento, escrituras más seguras en unidades de red y carpetas sincronizadas en la nube, visibilidad de fallos de MCP tools/list, y varias correcciones de background sessions, subagents, Remote Control, portapapeles, settings y zonas horarias. La Claude Code Action allowlisted también elevó sus versiones integradas por defecto a Claude Code 2.1.181 y Claude Agent SDK 0.3.181. Para repositorios jurídicos, vuelva a probar cambios de settings gestionados, permisos de automatización de macOS, comportamiento de escritura en carpetas cloud, comprobaciones de estado MCP, retención de historial de background sessions, controles de profundidad de subagents y pins de versión de GitHub Action antes de que flujos no supervisados toquen carpetas con datos de clientes.

Verificación de fuentes de Claude Code 2.1.183

Claude Code 2.1.183 refuerza la seguridad del modo auto bloqueando comandos destructivos de Git e infraestructura que no se solicitaron, avisa cuando un modelo pedido está obsoleto o se actualiza automáticamente, añade un ajuste attribution.sessionUrl para atribución de commits y PR, corrige la clasificación de triggers de tareas programadas y webhooks para que no puedan aprobar acciones pendientes, y corrige la exposición de herramientas MCP auth-stub en modo headless y SDK. La Claude Code Action allowlisted también elevó sus versiones integradas por defecto a Claude Code 2.1.183 y Agent SDK 0.3.183. Para repositorios jurídicos, vuelva a probar las puertas de revisión de comandos destructivos, los límites de aprobación de webhooks y tareas programadas, las advertencias por retirada de modelos, la política de atribución de PR, la exposición de autenticación MCP y los pins de versión antes de que flujos no supervisados toquen carpetas con datos de clientes.

Filtrado de reviews de PR por Claude Action

Un commit allowlisted de junio de 2026 para Claude Code Action ahora filtra pull-request reviews e inline review comments al authorized trigger time, igual que ya hace con issue/PR comments y bodies. Para legal PR agents, fije una versión que incluya este fix, trate los review threads añadidos después del trigger como contexto de referencia no confiable, mantenga checkout credentials no persistentes y exija revisión humana de merge antes de que cambios redactados por agentes lleguen a repositorios con datos de clientes.

Objetivos de aprendizaje

Al finalizar este tutorial podrá:

  • Comprender la arquitectura de Claude Code (Skills, Hooks, Sub-agents)
  • Construir competencias jurídicas personalizadas para los flujos de su despacho
  • Crear hooks para control de calidad y verificación de cumplimiento
  • Desplegar sistemas multi-agente para tareas jurídicas complejas

Parte 1: Comprender la pila Claude Code

Arquitectura

Skills: Instrucciones especializadas y buenas prácticas almacenadas en archivos que Claude lee según el contexto.

Hooks: Scripts que se ejecutan en puntos específicos del ciclo de vida de ejecución de Claude.

Sub-agents: Agentes autónomos lanzados para gestionar sub-tareas específicas.

MCP Servers: Conexiones a herramientas externas (Tutorial 07).

Plugins: Paquetes de Skills + Hooks + MCP.

Aplicación jurídica

ComponenteAplicación jurídica
SkillsCodificar playbooks, procedimientos de revisión, estándares de redacción
HooksAplicar verificación de cumplimiento, prevenir acciones no autorizadas, registro de auditoría
Sub-agentsParalelizar revisión documental, tareas de investigación
PluginsEmpaquetar flujos del despacho para distribución

Parte 2: Construir competencias jurídicas personalizadas

¿Qué es un Skill?

Los Skills son instrucciones especializadas almacenadas en archivos que Claude lee según el contexto. A diferencia de los prompts (puntuales), los Skills persisten y se activan automáticamente.

Estructura de un Skill

tu-skill/
├── SKILL.md          # Instrucciones principales (requerido)
├── examples/         # Ejemplos entradas/salidas
├── templates/        # Plantillas de documentos
└── resources/        # Materiales de referencia

Crear un Skill de revisión contractual

Paso 1: Crear el directorio del skill (véase la sección en inglés para el comando).

Paso 2: Redactar SKILL.md con Purpose, Activation, Instructions, Output format.

Paso 3: Añadir ejemplos good/bad en examples/.

Parte 3: Hooks para calidad y cumplimiento

Los hooks se ejecutan antes/después de acciones. Úselos para: validar salidas antes de enviar, bloquear acciones no autorizadas, registrar accesos a datos sensibles.

Nota de producción: Los hooks pueden bloquear o modificar un flujo. Pruébelos en sandbox con los permisos, niveles de esfuerzo y servidores MCP reales antes de usarlos en expedientes de clientes o documentos privilegiados.

¿Qué son los Hooks?

Scripts que se ejecutan en puntos específicos: PreToolUse, PostToolUse, SessionStart, UserPromptSubmit, Stop. Véase la sección en inglés para la tabla.

Ejemplo de hook de cumplimiento jurídico

Impedir modificaciones no autorizadas en carpetas privilegiadas. Véase la sección en inglés para el código.

Otros casos de uso de hooks

Verificación de citas, control de confidencialidad. Véase la sección en inglés para los ejemplos.

Parte 4: Flujos multi-agente jurídicos

Entender los sub-agentes

Claude puede lanzar sub-agentes para tareas específicas: paralelización (varios documentos revisados simultáneamente), especialización (agentes dedicados), aislamiento (contexto separado).

Ejemplo: Revisión de due diligence paralela

Varios agentes en paralelo (contratos clientes, IP, empleo, litigios). Véase la sección en inglés para el código.

Ejemplo: Investigación + redacción

Agente investigación → agente redacción → agente revisión. Véase la sección en inglés para el flujo.

Parte 5: Empaquetar Skills en plugins

Estructura de plugin

Directorio con plugin.json, SKILL.md, .mcp.json, hooks/, commands/, resources/. Véase la sección en inglés para la estructura completa.

Manifiesto del plugin

El formato y esquema del manifiesto evolucionan. Consulte la referencia oficial de plugins.

Instalación y distribución

claude --plugin-dir, claude plugin install, claude plugin enable. Véase la sección en inglés para los comandos.

Parte 6: Consideraciones de seguridad

Seguridad de skills

Verificación de fuentes, revisión del código de hooks, no incluir datos de clientes en skills, control de acceso.

Protección de datos

Hooks UserPromptSubmit para sanitización. Véase la sección en inglés para el ejemplo.

Requisitos de cumplimiento

  • Skills revisados por seguridad IT
  • Hooks probados en sandbox
  • Audit logging activado
  • Segregación de datos de clientes verificada

Haga ahora

  • Crear un skill personalizado para un proceso de revisión de su despacho
  • Añadir al menos un hook de seguridad para cumplimiento o auditoría
  • Probar un flujo multi-agente para procesamiento paralelo de documentos
  • Documentar su skill para su equipo
  • Considerar empaquetar como plugin para distribución

Páginas familia relacionadas

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

On this page

1 What You'll Learn2 Objetivos de aprendizaje3 Parte 1: Comprender la pila Claude Code3.1 Arquitectura3.2 Aplicación jurídica4 Parte 2: Construir competencias jurídicas personalizadas4.1 ¿Qué es un Skill?4.2 Estructura de un Skill4.3 Crear un Skill de revisión contractual5 Parte 3: Hooks para calidad y cumplimiento5.1 ¿Qué son los Hooks?5.2 Ejemplo de hook de cumplimiento jurídico5.3 Otros casos de uso de hooks6 Parte 4: Flujos multi-agente jurídicos6.1 Entender los sub-agentes6.2 Ejemplo: Revisión de due diligence paralela6.3 Ejemplo: Investigación + redacción7 Parte 5: Empaquetar Skills en plugins7.1 Estructura de plugin7.2 Manifiesto del plugin7.3 Instalación y distribución8 Parte 6: Consideraciones de seguridad8.1 Seguridad de skills8.2 Protección de datos8.3 Requisitos de cumplimiento9 Haga ahora10 Páginas familia relacionadas11 Navegación12 Quick Reference: Claude Code Commands13 Sources14 Additional Reading