Tienes carpetas de guías de IA guardadas. Capturas de pantalla, PDFs, hilos que marcaste. En el momento en que las guardaste pensaste que las ibas a usar. No las usaste.
No es flojera. Es que una guía guardada te obliga a acordarte de que existe, encontrarla, releerla y traducirla a un prompt, justo cuando estás ocupado haciendo la tarea. Ese costo es más alto que el de improvisar, así que improvisas.
La solución no es organizar mejor las guías. Es convertirlas en algo que Claude use solo, o que tú invoques con una palabra. Eso es una skill, y escribirla toma unos diez minutos por guía.
Qué es una skill, sin rodeos
Una skill es una carpeta con un archivo SKILL.md adentro. Ese archivo tiene dos partes: unas líneas de metadatos arriba, entre ---, que le dicen a Claude cuándo usarla; y abajo, el procedimiento en markdown.
El nombre de la carpeta se vuelve el comando. Una carpeta llamada auditar-anuncios te da /auditar-anuncios. Y si la descripción está bien escrita, Claude la carga solo cuando el tema aparece, sin que la invoques.
La ventaja sobre pegar la guía en el chat cada vez: el cuerpo de la skill solo se carga cuando se usa. Puedes tener veinte skills largas sin que ninguna te cueste contexto hasta que hace falta.
Dónde vive
- Personal —
~/.claude/skills/<nombre>/SKILL.md. Disponible en todos tus proyectos. - Del proyecto —
.claude/skills/<nombre>/SKILL.mddentro del repositorio. Se comparte con quien trabaje ahí.
Para algo que sacaste de una guía y quieres usar en todos lados, va en la personal. Para un procedimiento de tu empresa que tu equipo también debe seguir, va en la del proyecto y se sube al repositorio como cualquier archivo.
Los cuatro pasos
- Baja la guía completa. El PDF, el artículo, el video con su transcripción. Completa, no el resumen.
- Pásasela a Claude con el prompt de abajo.
- Guarda el resultado en la carpeta que le corresponda.
- Pruébala en una sesión nueva. Este paso no es opcional y explico por qué más abajo.
El prompt que convierte la guía en skill
Te voy a dar una guía. Quiero que la conviertas en una skill de
Claude: un archivo SKILL.md que yo pueda guardar y reusar.
Antes de escribir nada, hazme estas tres preguntas y espera mi
respuesta:
1. ¿En qué momento de mi trabajo quiero que esto se dispare?
2. ¿Cuál es el resultado que espero cuando corre bien?
3. ¿Qué de mi contexto (mi negocio, mis herramientas, mi forma
de trabajar) tiene que quedar dentro de la skill?
Después escribe el archivo con estas reglas:
FRONTMATTER
- Entre marcadores ---
- Campo `description`: qué hace la skill Y cuándo usarla, en una
o dos frases. Empieza por el caso de uso principal, porque es
con esto con lo que decides cargarla o no. Escríbelo en tercera
persona, describiendo la situación del usuario.
CUERPO
- Instrucciones, no explicación. Nada de por qué es importante
el tema, nada de introducción.
- Pasos numerados en el orden real de ejecución.
- Los criterios de decisión explícitos: qué hacer cuando falta
un dato, cuándo preguntarme y cuándo asumir el default.
- El formato exacto de salida que espero.
- Una sección "Errores comunes" con lo que la guía advierta que
sale mal.
- Si la guía trae ejemplos, deja uno completo. Un ejemplo hace
más que tres párrafos de instrucción.
REGLAS DURAS
- No inventes pasos que la guía no dice.
- Si la guía es vaga en algún punto, márcalo con un comentario
en vez de rellenarlo.
- Máximo 400 palabras en el cuerpo. Si no cabe, dime qué dejaste
fuera y por qué.
Devuélveme el archivo completo en un solo bloque, listo para
guardar. Al final, aparte, dime el nombre de carpeta que le
pondrías y tres frases que yo podría escribir en el chat que
deberían activar esta skill sola.
Aquí está la guía:
[pega o adjunta la guía]
Cómo se ve el resultado
Este es un ejemplo corto, para que veas la forma. Sale de una guía de revisión de creativos de anuncios:
---
description: Revisa creativos de anuncios antes de subirlos a
la cuenta. Úsala cuando el usuario comparta un anuncio, un
copy publicitario o un guion de video para pauta, o pida
feedback sobre creativos.
---
## Qué hacer
1. Identifica el objetivo declarado del anuncio. Si no está,
pregúntalo antes de revisar.
2. Revisa en este orden y no lo cambies:
hook (primeros 3 segundos) / claridad de la oferta /
prueba / llamado a la acción.
3. Para cada uno: qué está bien, qué falla, y la corrección
concreta. Nada de "podría mejorarse".
4. Marca cualquier promesa de resultado que no traiga sustento.
## Formato de salida
Una tabla mental de 4 filas, un veredicto de una línea, y la
única corrección que haría antes de subirlo.
## Errores comunes
- Comentar el diseño y saltarse el hook.
- Dar cinco correcciones. Una sola, la que más mueve la aguja.
El paso que todo mundo se salta: probarla en una sesión nueva. Si la pruebas en la misma conversación donde la escribieron, Claude ya tiene todo el contexto en la cabeza y la skill parece perfecta aunque le falte la mitad. Abre una sesión limpia, escribe una de las frases que te sugirió, y verifica dos cosas por separado: que la skill se haya activado, y que el resultado sea el que querías. Son dos fallas distintas y se arreglan distinto.
Las dos fallas y su arreglo
No se activa. El problema está en la descripción, no en el cuerpo. Casi siempre porque describe qué hace la skill pero no cuándo usarla, o porque usa el vocabulario de la guía en vez del tuyo. Si tú dices "creativos" y la descripción dice "activos publicitarios", nunca va a coincidir. Mete tus palabras reales.
Se activa y sale mal. Ahí sí es el cuerpo. La causa habitual es que quedó explicativo en vez de imperativo. Una skill no enseña, ordena. Cambia todo "es importante considerar" por "haz esto".
El error de fondo
La tentación es convertir todas tus guías guardadas en skills en una tarde. Vas a acabar con quince skills que compiten entre sí y ninguna que uses.
La regla que aplico: solo se vuelve skill lo que ya hiciste a mano al menos tres veces. Si nunca has aplicado esa guía manualmente, no sabes dónde truena, y lo que vas a empaquetar es la teoría de alguien más con formato bonito.
Empieza por la guía que sí usaste y te dio flojera repetir. Esa es la que vale. Cuando ya tengas tres o cuatro corriendo, sigue con por qué no jala tu skill para afinarlas, o mira las skills gratis que ya existen antes de escribir una que alguien más ya resolvió.