⏱️ Lectura: 9 min
La mayoría de contratos que firman freelancers, PyMEs y agencias nunca pasan por un abogado. No es por negligencia: es por precio. Una revisión legal básica cuesta entre USD 1.500 y 3.000, y el 82% de los freelancers admite no leer los contratos completos antes de firmar. El resultado es previsible: cláusulas de IP tóxicas, penalizaciones asimétricas, obligaciones abiertas, indemnidades ilimitadas. El costo de una sola cláusula mal negociada supera con frecuencia los diez mil dólares.
📑 En este artículo
En ese contexto nace ai-legal-claude, un proyecto open source que convierte a Claude Code en un revisor de contratos capaz de analizar un PDF en menos de un minuto, identificar cláusulas riesgosas, generar NDAs, traducir legalese a español plano y producir reportes en PDF listos para enviar a un cliente. Con 776 estrellas y 204 forks en el momento de escribir esto, el repo zubair-trabzada/ai-legal-claude se ha consolidado como una de las skills más descargadas del ecosistema Claude Code en 2026.
Qué es ai-legal-claude
Técnicamente, ai-legal-claude no es una librería ni un servicio en la nube. Es un conjunto de 14 skills y 5 agentes para Claude Code, distribuidos como archivos SKILL.md y agents/*.md que el propio Claude Code lee y ejecuta cuando el usuario invoca un comando como /legal review. La única dependencia de runtime externa es Python 3.8+ con la librería reportlab, necesaria únicamente para generar los reportes PDF finales.
La arquitectura divide el trabajo en dos capas. Por un lado están las skills, que son pequeños manifiestos en Markdown con instrucciones que el modelo sigue al recibir cierto comando. Por otro, los agents son subprocesos especializados que Claude Code lanza en paralelo: uno analiza cláusulas, otro puntúa riesgos, otro valida compliance, otro mapea obligaciones y plazos, y el último sintetiza recomendaciones. Esta separación es lo que le permite procesar un contrato de 40 páginas en un solo turno de conversación sin saturar el contexto.
El repo está escrito mayoritariamente en Python (solo el generador de PDF lo requiere), pero el 90% del valor vive en los archivos Markdown que describen el comportamiento de cada skill. Es un ejemplo canónico del patrón prompt-as-code que Anthropic viene empujando desde la introducción de las skills en Claude Code a finales de 2025.
Instalación
El repo ofrece un instalador universal que copia los archivos a la carpeta correcta de Claude Code. Funciona igual en las tres plataformas principales, pero hay matices que conviene cubrir.
Linux
En distribuciones con curl y bash disponibles (prácticamente todas), una sola línea basta:
curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/ai-legal-claude/main/install.sh | bash
pip3 install reportlab
El script copia las skills a ~/.claude/skills/ y los agentes a ~/.claude/agents/. Si Claude Code ya está corriendo, hay que cerrarlo y abrirlo de nuevo para que detecte las nuevas skills.
macOS
En macOS el flujo es idéntico al de Linux, pero conviene asegurar que python3 apunta a una versión 3.8+ antes de instalar reportlab:
python3 --version
curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/ai-legal-claude/main/install.sh | bash
python3 -m pip install --user reportlab
Si usás Homebrew y tenés varias versiones de Python instaladas, creá un entorno virtual dedicado para evitar conflictos con el Python del sistema.
Windows
El instalador oficial no soporta PowerShell de forma nativa, pero funciona sin cambios dentro de WSL2 o Git Bash. La opción más estable es WSL2 con Ubuntu:
wsl --install -d Ubuntu
wsl
curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/ai-legal-claude/main/install.sh | bash
pip3 install reportlab
Para quienes prefieren quedarse en PowerShell nativo, una alternativa es clonar el repo y copiar manualmente las carpetas skills/ y agents/ a %USERPROFILE%\.claude\. El autor documenta esta vía en el README, pero WSL sigue siendo el camino recomendado por compatibilidad con el script de PDF.
Uso básico
Una vez instalado, el primer ejemplo funcional es simplemente invocar la skill estrella sobre un archivo local. Claude Code la detecta automáticamente y lanza los cinco agentes en paralelo:
/legal review ./contrato-cliente.pdf
El resultado que devuelve el modelo tiene una estructura fija: un Contract Safety Score de 0 a 100 con calificación en letras, un dashboard de riesgos que cuenta cláusulas de alto, medio y bajo peligro, un análisis cláusula por cláusula traducido a español plano, una lista de protecciones que deberían estar y no están, una línea de tiempo con obligaciones y fechas límite, banderas de compliance regulatorio y finalmente un listado ordenado de prioridades de negociación.
Para casos más puntuales, cada skill funciona de forma independiente. Si solo necesitás traducir un contrato inglés lleno de whereas y hereinafter a español claro:
/legal plain ./msa-vendor.pdf
O generar un NDA mutuo entre tu agencia y un cliente nuevo:
/legal nda "NDA mutuo entre mi agencia y un cliente fintech para un piloto de 90 dias"
Integración en proyectos reales
Donde ai-legal-claude se vuelve interesante es cuando deja de ser una herramienta aislada y se integra en un flujo de trabajo recurrente. Un patrón que vimos funcionar en varias agencias LATAM es combinar /legal review con /legal report-pdf para ofrecer un servicio de revisión contractual con precio fijo. El freelancer recibe un contrato del cliente, lo pasa por el revisor, genera el PDF y lo entrega en menos de una hora.
# 1. Revision completa del contrato
/legal review ./contrato-saas.pdf
# 2. Busqueda especifica de protecciones faltantes
/legal missing ./contrato-saas.pdf
# 3. Generacion de contrapropuestas con lenguaje de reemplazo
/legal negotiate ./contrato-saas.pdf
# 4. Reporte PDF listo para el cliente
/legal report-pdf
Otro patrón menos obvio es el de comparación de versiones. Cuando un cliente manda un contrato con cambios sobre una versión ya negociada, /legal compare detecta adiciones, remociones y sustituciones peligrosas que a simple vista pasan desapercibidas:
/legal compare ./contrato-v1.pdf ./contrato-v2.pdf
El tercer patrón útil es la auditoría de compliance sobre sitios web. Apuntando /legal compliance a una URL, el modelo escanea qué datos recolecta el sitio y contrasta contra GDPR, CCPA, ADA, PCI-DSS, CAN-SPAM y SOC 2, señalando brechas concretas. Para agencias que venden desarrollo web, este chequeo convierte un entregable técnico en un entregable legal con valor percibido mucho mayor.
Cuándo usarlo y cuándo no
Es importante ser honestos: ai-legal-claude no reemplaza a un abogado y el propio README lo deja claro en su disclaimer. Es una herramienta de triaje, no de asesoría legal. Hay casos de uso donde aporta mucho valor y otros donde puede generar una falsa sensación de seguridad.
Úsalo cuando necesites entender rápidamente qué dice un contrato antes de reunirte con tu abogado, cuando quieras preparar preguntas informadas para esa reunión, cuando revises contratos estándar de bajo riesgo (NDAs simples, SOWs repetitivos, acuerdos de freelance), cuando ofrezcas revisión contractual como servicio de primera línea antes de derivar a un profesional, o cuando hagas auditorías de compliance rutinarias sobre tu propia web.
Evitalo cuando el contrato implique jurisdicciones exóticas, regulaciones sectoriales muy específicas (farma, defensa, banca con entes reguladores locales), montos de exposición financiera altos sin revisión humana posterior, cláusulas penales en idiomas distintos al inglés o español, o cuando la contraparte tenga un equipo legal agresivo. En esos escenarios el análisis automatizado es un punto de partida, no el producto final.
Alternativas
El espacio de legaltech con IA creció rápido en los últimos dos años. Tres alternativas que vale la pena conocer:
- Harvey AI — Plataforma SaaS enfocada en firmas de abogados grandes. Integra con sistemas de gestión documental corporativa (iManage, NetDocuments) y tiene modelos entrenados específicamente en jurisprudencia anglosajona. Requiere suscripción empresarial y no es open source.
- Spellbook — Extensión de Microsoft Word que ofrece revisión y redacción asistida dentro del flujo de trabajo habitual de abogados. Cobra por asiento y su foco está en la redacción asistida más que en el análisis de riesgos.
- LegalRobot — API de análisis contractual con modelos propios. Buena para integración programática en plataformas que procesan volúmenes altos de contratos, pero menos flexible para casos personalizados.
Frente a estas opciones, ai-legal-claude juega en otra liga: es gratis, corre localmente, se adapta fácilmente modificando los archivos Markdown de las skills, y aprovecha el contexto largo de Claude para analizar contratos extensos sin chunking agresivo. A cambio, carece de las integraciones empresariales y el soporte comercial que ofrecen las otras tres.
Conclusión
ai-legal-claude es un ejemplo concreto de cómo las skills de Claude Code están cambiando la forma de distribuir automatización: ya no hacen falta servicios SaaS ni APIs propietarias, basta con un repo en GitHub con archivos Markdown bien escritos. El proyecto democratiza el acceso a una primera capa de análisis contractual que antes costaba miles de dólares y demuestra que la combinación de agentes paralelos más un orquestador bien diseñado produce resultados útiles en minutos.
No es un reemplazo del trabajo humano calificado, pero sí un filtro de primera línea que evita firmar a ciegas. Para freelancers y PyMEs de la región, eso ya es una mejora enorme sobre el statu quo actual.
El código, los 14 comandos y el instalador universal están disponibles en el Repositorio oficial en GitHub bajo el usuario zubair-trabzada.
Referencias
- zubair-trabzada/ai-legal-claude — Repositorio oficial
- AI Workshop — Comunidad del autor
- AI Marketing Suite — proyecto hermano
- AI Sales Team — proyecto hermano
- ReportLab — librería usada para los PDFs
📱 ¿Te gusta este contenido? Únete a nuestro canal de Telegram @programacion donde publicamos a diario lo más relevante de tecnología, IA y desarrollo. Resúmenes rápidos, contenido fresco todos los días.
0 Comentarios