Skills: procedimientos reutilizables

Resultado

Al terminar tendrás una Skill mínima para revisar documentos, un conjunto de casos de prueba y una regla de mantenimiento. La Skill describirá un procedimiento acotado; no afirmará capacidades que sus instrucciones, recursos o herramientas no puedan realizar.

Conceptos

Una Skill es una carpeta de instrucciones, scripts y recursos que Claude puede cargar cuando una tarea coincide con su descripción. Su contenido se incorpora de forma progresiva, por lo que el nombre y la descripción ayudan a decidir cuándo utilizarla.

No es lo mismo que:

• un Project, que organiza contexto y conversaciones de un trabajo;
• un Connector o MCP, que puede exponer datos y herramientas;
• una automatización, que además necesita disparadores, permisos, estados y registro.

Una Skill personalizada incluye un archivo SKILL.md con metadatos YAML. Conviene que resuelva un solo procedimiento y que sus instrucciones indiquen entradas, pasos, salida, controles y límites.

---
name: revision-documental
description: Revisa un documento contra una lista de criterios y devuelve hallazgos con ubicación y estado de evidencia.
---

# Revisión documental

Usa solo los archivos entregados para la tarea.
Separa evidencia, inferencia y dato faltante.
No edites, envíes ni publiques documentos.
Devuelve una tabla con criterio, hallazgo, ubicación y estado.

Los scripts o paquetes incluidos amplían el riesgo. Usa solo código entendido y procedente de una fuente confiable; una Skill no debe ocultar operaciones de red, escritura o ejecución innecesarias.

Práctica guiada

1. Define un procedimiento repetido de bajo riesgo, como revisar la estructura de un informe público.
2. Especifica entradas permitidas y excluidas.
3. Redacta name y description para activar la Skill solo en ese caso.
4. Escribe pasos que produzcan una tabla con criterio, evidencia, ubicación, estado y acción sugerida.
5. Añade una regla: si no existe evidencia, conservar el campo como pendiente.
6. Prueba tres casos: documento completo, documento incompleto y documento fuera de alcance.
7. Registra versión, propietario, fecha de prueba y cambio realizado.

No añadas herramientas ni scripts si las instrucciones son suficientes. La complejidad debe responder a una necesidad comprobada.

Checklist de validación

• La Skill cubre un solo procedimiento reconocible.
• Nombre y descripción coinciden con su alcance real.
• Entradas, salida y exclusiones están documentadas.
• Los faltantes no se convierten en información inventada.
• No existen acciones externas implícitas.
• Scripts y recursos proceden de fuentes confiables y fueron revisados.
• Hay casos de prueba y una versión registrada.

Mini evaluación

1. ¿Cuándo conviene una Skill en lugar de un Project?
2. ¿Qué función cumple la descripción de una Skill?
3. ¿Por qué una Skill de terceros requiere revisión?

Respuestas

1. Cuando quieres reutilizar un procedimiento específico en distintos contextos, no solo organizar el conocimiento de un trabajo.
2. Ayuda a identificar el propósito y cuándo debe cargarse.
3. Puede contener instrucciones, scripts o recursos que accedan a datos o ejecuten operaciones no deseadas.

Fuentes y límites

• Qué son las Skills.
• Usar Skills en Claude.
• Crear Skills personalizadas.
• Descripción técnica de Agent Skills.

La disponibilidad de Skills y la ejecución de código pueden depender del producto o plan. Una Skill mejora consistencia, pero no garantiza exactitud ni cumplimiento. Prueba con datos sintéticos y revisa cualquier recurso de terceros antes de habilitarlo.