De la libreta de prompts a skills

01 · Qué es, sin rodeos

Un archivo de texto llamado SKILL.md con cuatro datos arriba y las instrucciones debajo, en español llano. Anthropic publicó la especificación en diciembre de 2025 y en cuarenta y ocho horas ya la leían Microsoft y OpenAI. Por eso el mismo archivo vale en Claude Code, en Codex, en Cursor o en VS Code.

02 · Empieza por el que más repites

No por el más impresionante. Abre donde guardes tus prompts y busca el que has pegado más veces este mes: ese ya está probado y ya sabes cómo tiene que salir.

03 · Conviértelo

Pégale el prompt tal cual y pídele esto. Lo importante es la segunda frase: sin ella escribe una descripción vaga y la skill no se activa nunca.

Este es un prompt que uso mucho. Conviértelo en una skill.
La descripción tiene que decir CUÁNDO usarla, con las palabras que yo diría al pedirlo, no un resumen de lo que hace.
Antes de escribirla, pregúntame qué no debe hacer nunca y cómo se sabe que ha quedado bien.

04 · Dónde se guarda

En .claude/skills/ dentro de un proyecto si es de ese proyecto, o en ~/.claude/skills/ si la quieres en todos. La segunda es la que convierte tu forma de trabajar en algo que te sigue a todas partes.

05 · Cómo se la llevas a otra herramienta

Copiando la carpeta. No hay exportación ni conversión: el mismo archivo que lee Claude Code lo lee Codex. Comprueba en la documentación de la otra herramienta en qué carpeta las busca, que es lo único que cambia.

06 · Cómo saber si está bien escrita

Abre un chat nuevo, sin decir nada de la skill, y pide lo de siempre con tus palabras. Si entra sola, la descripción está bien. Si no entra, no reescribas las instrucciones: reescribe la descripción, que es donde está el fallo el 90% de las veces.