Qué son los skills de IA y cómo escribir el tuyo

Este es el problema que un skill resuelve: te la pasas tecleando las mismas instrucciones. "Cuando te pida un resumen, déjalo en tres viñetas." "Cuando le respondas a un cliente, empieza con calidez." La IA lo hace bien cada vez, pero te estás repitiendo, y el resultado se desvía un poco cada vez porque redactas la instrucción un poco distinta.

Un skill arregla las dos cosas. Es una notita que escribes una sola vez y que dice "así es exactamente como se hace esta tarea". Tu asistente de IA la carga sola, pero solo cuando llega el momento justo. No la pegas cada vez. Ni siquiera tienes que acordarte de que existe. La IA se da cuenta de que la tarea encaja con tu nota y la agarra.

Esta guía te muestra cómo se ve un skill por dentro y después te lleva a escribir el tuyo. No necesitas saber programar. Al terminar vas a tener un skill chiquito y funcional, y lo vas a haber activado tú mismo.

01 · La analogía de la tarjeta de receta

Imagínate una cocina con mucho movimiento. El chef sabe preparar mil cosas, pero no carga todas las recetas en la cabeza a la vez. Tiene una caja de tarjetas de receta. Cuando entra una orden de sancocho, agarra la tarjeta del sancocho, y solo esa. La tarjeta tiene dos cosas: el nombre del plato, para saber cuándo agarrarla, y los pasos, para saber qué hacer.

Un skill funciona como una de esas tarjetas.

• El nombre y la descripción son el frente de la tarjeta. Le dicen a la IA cuándo esta es la tarjeta correcta para sacar.
• Los pasos son el reverso de la tarjeta. Le dicen a la IA qué hacer una vez que la sacó.

La parte útil: el chef no lee las mil tarjetas cada vez. Eso sería lento. Saca la única tarjeta que encaja con la orden. Los skills funcionan igual. La IA guarda tus skills en una caja y saca solo el que encaja con lo que pediste. Por eso puedes tener muchos skills sin volver lenta a la IA. Cada uno se queda quietecito hasta que llega su momento.

02 · ¿Por qué no pedirlo cada vez?

Buena pregunta. Puedes escribir tus instrucciones cada vez que quieras algo. Para una tarea de una sola vez, está bien. Los skills valen la pena cuando una tarea se repite.

Piensa en explicarle a alguien cómo llegar a tu casa una vez, contra guardar la dirección en su teléfono. La primera vez le explicas cada vuelta. Después solo toca la dirección guardada. Los skills son la "dirección guardada" para las tareas que haces una y otra vez.

Tres beneficios concretos:

1. Consistencia. Un skill hace la tarea igual cada vez. Si le pides a la IA "escribe un commit message" desde cero cada día, te va a salir un estilo un poco distinto cada día. Un skill congela el estilo para que sea el mismo el lunes y el viernes.
2. No volver a teclear. Escribes las instrucciones una sola vez. Después, con un pedido corto basta. La IA completa los detalles desde el skill.
3. Se activa solo. Esta es la parte que sorprende. No tienes que acordarte de usar el skill. Describes lo que quieres con palabras normales, y si encaja con la descripción del skill, la IA lo agarra, como el chef que toma la tarjeta correcta sin que le digan cuál.

Aquí va el límite honesto, porque aquí no vendemos humo: un skill no es más listo que las instrucciones que le pones. Hace a la IA consistente, no brillante. Un skill vago produce resultados vagos. Un skill claro produce resultados claros. La calidad que sacas es la calidad que escribiste.

03 · Cómo se ve un skill por dentro

Abramos la caja y miremos una tarjeta. Un skill es un archivo de texto plano. Tiene dos partes, y puedes leer las dos sin saber nada de código.

La primera parte, arriba del todo, es el frontmatter. Piénsalo como la etiqueta del frente de la tarjeta de receta. Va entre dos líneas de tres guiones y guarda el nombre y la descripción.

La segunda parte, debajo de la etiqueta, es el cuerpo, los pasos de verdad, escritos en frases normales.

Aquí va un skill completo y real. Léelo como una nota, porque eso es todo lo que es:

---
name: explain-like-im-5
description: >
  Explica una idea difícil de la forma más simple posible, como si
  fuera para un niño curioso. Úsalo cuando el usuario pida "explícalo
  como si tuviera cinco años", "ELI5", "explícame esto simple" o diga
  que no entiende algo técnico y lo quiere en palabras sencillas.
---

Le estás explicando una idea difícil a un niño de cinco años,
listo y curioso.

1. Empieza con una comparación cotidiana. Compara la idea con algo
   que un niño ya conoce: juguetes, comida, animales, el clima.

2. Usa frases cortas. Nada de jerga. Si tienes que usar una palabra
   especial, explícala enseguida con palabras sencillas.

3. Da un ejemplo chiquito y concreto que se pueda imaginar.

4. Termina con una sola frase que lo resuma. Sin discursos.

Eso es todo. Eso es un skill entero. Pongámosle nombre a las piezas:

• name es el apodo corto del skill: en minúsculas, con guiones en vez de espacios. Es como el título arriba de la tarjeta de receta.
• description es la línea más importante del archivo. Le dice a la IA cuándo usar este skill. Fíjate que lista las frases que de verdad diría una persona: "explícalo como si tuviera cinco años", "ELI5", "explícame esto simple". Mientras más claro diga la descripción cuándo, mejor agarra la IA el skill en el momento justo.
• El cuerpo (todo lo que va debajo de los guiones) es el qué, los pasos sencillos que la IA sigue una vez que saca el skill.

04 · Escribe tu primer skill, paso a paso

Ahora escribimos uno juntos. Vamos a hacer un skill chiquito llamado commit-message. Escribe una línea corta y ordenada cada vez que guardas un grupo de cambios en un proyecto. (No te preocupes si "commit" te suena raro. Piénsalo como la nota de una línea que dejas cada vez que guardas tu trabajo, para que tu yo del futuro recuerde qué cambió.)

Vamos a mantener cada paso claro para principiantes.

Paso 1 · Encuentra la carpeta de skills

Los skills viven en una carpeta para que la IA sepa dónde buscarlos. En Claude Code, esa carpeta es un directorio oculto dentro de tu proyecto (o en tu carpeta personal) llamado .claude, con una carpeta skills adentro. Cada skill tiene su propia subcarpeta con el nombre del skill.

Así que la ruta a la que apuntamos se ve así:

.claude/
  skills/
    commit-message/
      SKILL.md

La carpeta llamada commit-message es la casa de nuestro skill. El archivo de adentro, SKILL.md, es la tarjeta de receta en sí. (El ".md" significa que es un archivo de texto plano en formato markdown, el mismo formato sencillo que se usa para notas y READMEs.)

Paso 2 · Crea la tarjeta

Dentro de la carpeta commit-message, crea un archivo llamado exactamente SKILL.md. Ábrelo en cualquier editor de texto. Sirve hasta el más básico, porque es solo texto. Después escribe esto:

---
name: commit-message
description: >
  Escribe un resumen corto y claro de una línea de los cambios
  guardados. Úsalo cuando el usuario pida "escribe un commit
  message", "resume mis cambios" o "¿cómo llamo a este guardado?".
---

Estás escribiendo un resumen de una línea de un grupo de cambios.

1. Déjalo en una sola línea, bajo 60 caracteres si puedes.

2. Empieza con un verbo en presente: "Agrega", "Arregla",
   "Actualiza", "Quita". Ejemplo: "Arregla typo en la página
   de registro".

3. Di QUÉ cambió en palabras sencillas. Sáltate el detalle técnico.

4. Devuelve solo la línea. Nada más.

Léelo de nuevo. ¿La descripción dice claro cuándo? ¿El cuerpo dice claro qué? Si es así, ya terminaste de escribir. Ese es, de verdad, el skill entero.

Paso 3 · Guárdalo

Guarda el archivo. No hay botón de "instalar" ni paso de compilación. En el momento en que el archivo queda guardado en la carpeta correcta, la IA puede encontrarlo. Un skill está vivo en el instante en que existe en el disco.

05 · Actívalo y míralo funcionar

Aquí viene la parte satisfactoria. No corres el skill por su nombre. Le hablas a la IA con palabras normales, y el skill se activa cuando tus palabras encajan con su descripción.

Abre Claude Code en el proyecto donde guardaste el skill y escribe algo como:

Acabo de arreglar un enlace roto en el footer. Escribe un commit message.

La frase "escribe un commit message" encaja con la descripción del skill, así que la IA saca la tarjeta y sigue los pasos. Te devuelve algo ordenado, como:

Arregla enlace roto en el footer

Una línea. Verbo en presente. Palabras sencillas. Sin ruido técnico. Eso es el skill haciendo su trabajo, y fíjate que nunca tuviste que volver a teclear las reglas. Estaban en la tarjeta.

Prueba el otro también. Pídele a la IA que te explique algo difícil:

Explícalo como si tuviera cinco años: ¿qué es el internet?

La frase "explícalo como si tuviera cinco años" encaja con la descripción del skill ELI5, así que se activa y recibes una respuesta amigable para niños armada desde una comparación cotidiana, justo los pasos que escribiste.

06 · Hazlo tuyo

Ahora tienes el ciclo completo: escribir la tarjeta, guardarla, activarla. De aquí en adelante, mejorar un skill es editar el archivo de texto y guardar otra vez. Sin reinstalar, sin ceremonia. Algunas mejoras fáciles cuando ya te sientas cómodo:

• Agrega más frases de activación a la descripción. Si te descubres diciendo "resume este guardado" y no se activa, agrega esa frase para que la próxima vez sí.
• Ajusta los pasos. Si la respuesta sale muy larga, agrega un paso que diga "déjalo en menos de tres frases". El skill hace exactamente lo que dicen los pasos, así que pasos más específicos dan respuestas más específicas.
• Arma una pequeña familia de skills. Una vez que uno funciona, el segundo te toma cinco minutos. Muchos skills chiquitos y claros le ganan a uno gigante y vago. Acuérdate de la caja de recetas: un montón de tarjetas de un solo propósito, cada una sacada solo cuando hace falta.

La mentalidad que hace que los skills hagan clic: no estás programando, estás delegando. Un skill es entregarle a la IA una instrucción escrita y clara, igual que le harías un encargo a un compañero nuevo y capaz. Dile sin rodeos cuándo hacerlo y qué hacer, y deja que se encargue desde ahí. Mientras más clara tu nota, mejor el resultado.

El mejor próximo paso es el más pequeño: elige una tarea que le pidas a la IA una y otra vez, como nombrar archivos, redactar respuestas o resumir notas, y conviértela en una tarjeta hoy. Escríbela, actívala, ajústala. La primera es la única que se siente nueva. Después de esa, vas a estar agarrando la caja de recetas sin siquiera pensarlo.