Si repites las mismas instrucciones cada semana, no necesitas otro prompt guardado: necesitas convertir tu método en una skill que Claude pueda aplicar cuando corresponda.
Qué vas a aprender
- Decidir cuándo una tarea merece convertirse en skill.
- Traducir tu forma de trabajar a instrucciones claras y comprobables.
- Crear la estructura mínima de una skill con
SKILL.md. - Agregar ejemplos, referencias, plantillas y scripts sin desordenarla.
- Instalarla en Claude o Claude Code y comprobar que se active bien.
- Detectar riesgos antes de usar skills de terceros.
01 · Qué es una skill y qué problema resuelve
Un procedimiento reutilizable, no una conversación guardada
Una skill es una carpeta con instrucciones y, si hace falta, archivos de referencia, plantillas o scripts. Claude lee primero su nombre y descripción. Cuando una tarea coincide, carga las instrucciones completas y usa los recursos necesarios.
Anthropic explica que las skills sirven para enseñar flujos especializados: aplicar lineamientos de marca, producir documentos con un formato interno o ejecutar un procedimiento repetible. La diferencia con un proyecto es importante. El proyecto mantiene conocimiento de fondo; la skill enseña cómo realizar una tarea. La explicación oficial está en Qué son las skills.
Ejemplo: una clínica veterinaria puede guardar sus servicios, tono y preguntas frecuentes dentro de un proyecto. Pero el procedimiento “convertir notas de consulta en un resumen para el tutor de la mascota” merece una skill si siempre exige los mismos pasos, advertencias y formato.
Usa esta prueba antes de construir nada:
¿CONVIENE CREAR UNA SKILL?
[ ] La tarea ocurre al menos dos veces al mes.
[ ] Tiene pasos que deberían repetirse en el mismo orden.
[ ] Existen criterios para aceptar o rechazar el resultado.
[ ] Puedo mostrar al menos dos ejemplos correctos.
[ ] El proceso no depende solo de información temporal.
[ ] Otra persona podría seguir el método si estuviera documentado.
Si marcas menos de cuatro, primero aclara el proceso.
No conviertas cada preferencia en una skill. “Respóndeme en español” pertenece a instrucciones generales. “Revisa una propuesta comercial contra nueve criterios y devuelve una tabla de riesgos” sí tiene forma de procedimiento.
02 · Extrae el método antes de escribir archivos
La calidad de la skill depende del proceso que documenta
El error habitual es abrir SKILL.md y empezar con “Eres un experto…”. Eso define un rol, pero no captura decisiones. Antes debes observar cómo haces la tarea tú.
Toma un caso terminado y reconstruye el recorrido:
- ¿Qué información recibiste?
- ¿Qué verificaste primero?
- ¿Qué decisiones tomaste?
- ¿Qué errores evitaste?
- ¿Qué formato entregaste?
- ¿Cómo supiste que estaba listo?
Ejemplo para una agencia: preparar un brief no consiste solo en resumir la reunión. Primero se separan hechos de supuestos, luego se detectan faltantes, se define el objetivo medible, se registran restricciones y recién después se redacta el documento.
Completa esta plantilla:
MAPA DEL PROCEDIMIENTO
Nombre: [tarea específica]
Se activa cuando: [situación o pedido]
No se usa cuando: [límites]
Entradas obligatorias:
- [dato o archivo]
Pasos:
1. [acción]
2. [decisión]
3. [validación]
Salida exacta:
- Formato: [Markdown, tabla, documento, JSON]
- Secciones: [lista]
Criterios de aprobación:
- [condición observable]
Casos que deben detenerse o escalarse:
- [riesgo o información faltante]
Si un paso dice “mejorar el texto”, todavía es demasiado vago. Cámbialo por algo observable: “eliminar promesas no respaldadas”, “reducir párrafos a un máximo de cuatro líneas” o “marcar precios sin fuente como [POR CONFIRMAR]”.
03 · Construye la estructura mínima
Empieza con una carpeta y un archivo
El estándar Agent Skills exige una carpeta que contenga SKILL.md. Ese archivo empieza con frontmatter YAML y continúa con instrucciones en Markdown. El nombre debe coincidir con la carpeta, usar minúsculas y guiones, y no superar 64 caracteres. La descripción debe explicar qué hace la skill y cuándo usarla. Puedes revisar las reglas completas en la especificación de Agent Skills.
Estructura inicial:
revisar-propuesta/
└── SKILL.md
Contenido mínimo funcional:
---
name: revisar-propuesta
description: Revisa propuestas comerciales de una PYME, detecta datos faltantes, promesas no respaldadas y riesgos antes del envío. Úsala cuando el usuario pida revisar, auditar o aprobar una propuesta.
---
# Revisar propuesta comercial
## Entradas
Necesitas la propuesta, la oferta vigente y los antecedentes del cliente.
Si falta alguno, solicítalo antes de aprobar.
## Proceso
1. Separa hechos, supuestos y promesas.
2. Verifica precios, plazos y alcance contra las fuentes entregadas.
3. Identifica datos faltantes y contradicciones.
4. Evalúa la propuesta con los criterios de `references/criterios.md`.
5. Devuelve hallazgos por prioridad y una versión corregida.
## Salida
Entrega: resumen ejecutivo, riesgos críticos, datos por confirmar,
cambios sugeridos y veredicto `APROBABLE` o `REQUIERE REVISIÓN`.
## Límites
No inventes precios, plazos, casos de éxito ni condiciones contractuales.
Anthropic recomienda que una skill resuelva una tarea concreta, defina cuándo debe usarse, tenga instrucciones claras e incluya ejemplos cuando aporten valor. Su guía actual está en Cómo crear skills personalizadas.
La descripción importa más de lo que parece: Claude la usa para decidir si debe cargar la skill. “Ayuda con ventas” es demasiado amplia. La versión del ejemplo menciona propuesta, auditoría, riesgos y aprobación; esas señales mejoran la activación y reducen usos incorrectos.
04 · Agrega recursos sin inflar SKILL.md
Carga cada detalle solo cuando haga falta
Una skill puede incluir carpetas opcionales:
revisar-propuesta/
├── SKILL.md
├── references/
│ ├── criterios.md
│ └── ofertas-vigentes.md
├── assets/
│ └── plantilla-salida.md
└── scripts/
└── validar_campos.py
Usa references/ para reglas extensas y conocimiento estable. Usa assets/ para plantillas que la salida debe reutilizar. Reserva scripts/ para validaciones deterministas o transformaciones que el código hace mejor que una instrucción.
Ejemplo: un script puede comprobar que una propuesta tenga cliente, fecha, moneda y vigencia. No debería decidir si la promesa comercial es prudente; esa evaluación necesita contexto y criterios.
En SKILL.md, explica cuándo leer cada recurso:
## Recursos
- Lee `references/criterios.md` antes de evaluar riesgos.
- Consulta `references/ofertas-vigentes.md` solo si la propuesta incluye precios.
- Usa `assets/plantilla-salida.md` para entregar el informe final.
- Ejecuta `scripts/validar_campos.py` cuando el archivo de entrada sea JSON.
El estándar recomienda mantener el archivo principal enfocado y cargar referencias bajo demanda. Esto se llama divulgación progresiva: el agente conoce primero la metadata, luego las instrucciones y finalmente los recursos que necesita. Así evita llenar el contexto con material irrelevante.
No guardes contraseñas, tokens ni datos privados de clientes dentro de la skill. Si requiere acceso externo, documenta el nombre de la variable o el conector esperado, pero almacena la credencial en el mecanismo seguro de la plataforma.
05 · Incluye ejemplos y casos borde
Una skill aprende mejor de resultados observables
Agrega al menos dos ejemplos normales y dos difíciles. No necesitas guardar documentos completos; basta con entradas y decisiones que aclaren el criterio.
## Ejemplos
### Caso normal
Entrada: propuesta con precio y plazo respaldados por la oferta vigente.
Resultado: APROBABLE, con mejoras de claridad de baja prioridad.
### Precio sin fuente
Entrada: propuesta ofrece implementación por USD 900, pero no existe una lista vigente.
Resultado: REQUIERE REVISIÓN. Marcar precio como [POR CONFIRMAR].
### Promesa riesgosa
Entrada: “Aumentaremos tus ventas un 30% en un mes”.
Resultado: REQUIERE REVISIÓN. Eliminar la garantía y describir el resultado operativo medible.
### Datos contradictorios
Entrada: la propuesta dice 4 semanas y el cronograma dice 6.
Resultado: detener aprobación, citar ambos lugares y pedir una definición.
Los casos borde evitan que la skill funcione bien solo cuando todo viene perfecto. Incluye información faltante, archivos contradictorios, solicitudes fuera de alcance y una entrada que debería rechazarse.
Usa esta matriz de prueba:
| Prueba | Debe activar | Conducta esperada |
|---|---|---|
| “Revisa esta propuesta antes de enviarla” | Sí | aplica todos los criterios |
| “Escribe una publicación para Instagram” | No | no carga la skill |
| Propuesta sin precio | Sí | solicita o marca el dato |
| Contrato legal para firma | No o escala | no reemplaza revisión legal |
06 · Instala, activa y prueba
Comprueba tanto la ejecución como el disparador
Las skills están disponibles en Claude para planes Free, Pro, Max, Team y Enterprise, con ejecución de código habilitada. En cuentas individuales, ve a Configuración → Capacidades, activa ejecución de código y creación de archivos, y luego entra a Personalizar → Skills. Anthropic documenta estos pasos en Usar skills en Claude.
Para subir una skill creada manualmente:
- Verifica que la carpeta y el campo
namecoincidan. - Comprime la carpeta completa como ZIP.
- En Personalizar → Skills, selecciona Agregar o Crear skill.
- Elige Subir skill y carga el ZIP.
- Actívala y prueba solicitudes que deberían y no deberían dispararla.
La estructura del ZIP debe conservar la carpeta raíz:
revisar-propuesta.zip
└── revisar-propuesta/
├── SKILL.md
├── references/
└── assets/
En Claude Code, las skills de equipo pueden vivir en .claude/skills/<nombre>/SKILL.md. La guía rápida oficial de Claude Code describe esa ubicación y su invocación mediante /nombre.
Después de instalar, prueba cinco frases variadas que deberían activarla y otras cinco que no. Si no se carga, mejora la descripción con palabras que una persona realmente usaría. Si se activa en exceso, reduce el alcance y explicita cuándo no corresponde.
07 · Reglas clave y seguridad
Una skill ejecutable merece la misma revisión que una herramienta
- Revisa todo antes de instalar — una skill puede incluir scripts, dependencias e instrucciones capaces de acceder a archivos o servicios.
- Usa fuentes confiables — Anthropic advierte sobre inyección de instrucciones y extracción de datos en skills de terceros.
- Prueba en un entorno acotado — no entregues acceso de producción a una skill que recién estás evaluando.
- Mantén un solo propósito — una skill que “hace todo el marketing” será difícil de activar, probar y corregir.
- Separa datos y procedimiento — el método vive en la skill; información temporal debería venir de una fuente vigente.
- Versiona cambios importantes — registra qué modificaste y qué caso fallido motivó el cambio.
- Conserva revisión humana — propuestas, precios, contratos y publicaciones externas requieren aprobación proporcional al riesgo.
Una buena primera skill no necesita código. Necesita una tarea real, pasos claros, criterios comprobables y ejemplos incómodos. Cuando funcione con diez casos distintos, recién ahí conviene agregar scripts o conexiones externas.