Crear una Skill

Paso 0 — Elige un problema concreto

Las mejores skills resuelven un problema específico. No "analizar contratos" sino "revisar cláusulas de resolución contractual en contratos de arrendamiento". No "buscar jurisprudencia" sino "buscar sentencias sobre responsabilidad patrimonial de la administración pública".

Pregúntate: ¿qué tarea repito más en mi trabajo? Esa es tu primera skill.

Paso 1 — Crea la estructura

Crea un directorio para tu skill con el siguiente esquema:

mi-skill/
├── metadata.yaml
└── SKILL.md

El archivo metadata.yaml contiene los metadatos de la skill:

slug: mi-skill
name: Mi Skill Legal
description: Breve descripción de lo que hace la skill
type: Skill
category: civil
country: ES
language: es

Paso 2 — Escribe el SKILL.md

El archivo SKILL.md es el corazón de la skill. Sigue esta estructura:

Trigger

Describe cuándo debe activarse la skill. Sé específico:

## Trigger
- Usuario solicita redactar una demanda civil/mercantil
- Usuario menciona "demanda", "escrito de alegaciones" o "iniciar procedimiento"
- Se proporciona información sobre un conflicto jurídico pendiente

Procedimiento

Enumera los pasos que el agente debe seguir. Cada paso debe ser accionable:

## Procedimiento
1. Solicitar datos: partes, hechos, fundamento jurídico
2. Identificar jurisdicción competente
3. Articular los hechos en orden cronológico
4. Fundamentar el derecho con normativa aplicable
5. Redactar las peticiones concretas
6. Calcular la cantidad y costas estimadas
7. Aplicar formato oficial de escrito judicial

Pitfalls

Lista los errores más comunes y cómo evitarlos:

## Pitfalls
- No incluir datos identificativos completos del demandado
- Olvidar especificar la competencia territorial
- Redactar hechos vagos sin concreción temporal
- Citar normativa derogada o modificada

Verificación

Cómo comprobar que el resultado es correcto:

## Verificación
- Revisar que todos los datos de las partes están completos
- Confirmar que la normativa citada está vigente
- Verificar que las peticiones son concretas y cuantificadas
- Comprobar el formato del escrito según la Ley de Enjuiciamiento Civil

Capabilidades

Enumera las herramientas o funcionalidades que la skill utiliza:

## Capabilidades
- Redacción de escritos judiciales
- Consulta normativa BOE
- Cálculo de cuantía y costas
- Formateo según estándares judiciales

Paso 3 — Pruébala en local

Copia el directorio de la skill a ~/.hermes/skills/ y ejecuta una prueba con datos de ejemplo. Verifica que el agente sigue cada paso correctamente.

Si algo falla, ajusta el SKILL.md y vuelve a probar. Itera hasta que el resultado sea consistente.

Paso 4 — Comparte la skill

Clona el repositorio de Legal Skills y añade tu skill en el directorio correspondiente:

git clone https://github.com/tuyo-ai/legal-skills.git
cd legal-skills
# Copia tu skill a data/skills/es/ES/mi-skill/
git add .
git commit -m "feat: add mi-skill"
git push

Abre un Pull Request y el equipo lo revisará antes de publicarlo en el directorio.

Buenas prácticas

• Se específico — Una skill que hace una cosa bien vale más que una que intenta hacerlo todo.
• Define la jurisdicción — Indica siempre el país y el idioma al que aplica.
• Añade pasos de verificación — Sin ellos, el agente no puede autocomprobar su trabajo.
• Documenta los pitfalls — Los errores que has cometido tú son conocimiento valioso para el siguiente usuario.
• Usa lenguaje claro — La skill se lee por el agente, no por humanos. Prioriza la precisión sobre la elegancia.

¿Qué sigue?

Una vez tu skill esté publicada, otros abogados y agentes la podrán usar. Si quieres profundizar en cómo las skills se diferencian de los servidores MCP, lee Skills vs MCP.