Cómo crear una skill en Claude Code: dos archivos de diez líneas

Llevo meses repitiéndole a Claude las mismas instrucciones. Hoy las guardé una vez y no volví a escribirlas.

En el video armamos dos skills en menos de diez minutos. Los dos archivos están en el repo del video. Si quieres la teoría de qué es una skill y en qué se diferencia de un agente, la dejé en 5 cosas que debes saber sobre los AI Skills. Aquí no la repito: vamos a lo práctico.

Qué es una skill

Una carpeta con un archivo: SKILL.md. Arriba van el nombre y la descripción; abajo, instrucciones en texto plano.

La descripción es lo importante. Claude la lee para decidir cuándo usar la skill. También puedes llamarla tú a mano con /nombre.

Hay dos lugares donde vive:

~/.claude/skills/<nombre>/SKILL.md: es tuya y vale para todos tus proyectos.
.claude/skills/<nombre>/SKILL.md: va dentro del repo y la comparte todo el equipo.

Las mías están escritas en español porque así hablo con Claude. Las tuyas pueden ir en el idioma que uses tú.

Skill 1: hackernews

Quería preguntar qué está pasando en Hacker News sin abrir el navegador. Este es el archivo completo:

---
name: hackernews
description: Busca lo que está sonando en Hacker News. Úsala cuando pida noticias de tech, qué hay en HN o temas para un video.
---

Busca las historias de portada en `https://hn.algolia.com/api/v1/search?tags=front_page` con curl.
Si te doy un tema, usa `https://hn.algolia.com/api/v1/search?query=<tema>&tags=story`.

Dame las 5 más interesantes: título, puntos y link. Una línea por noticia, en español, sin relleno.

No hay nada raro. Es como se lo explicarías a una persona: dónde buscar, qué hacer si te doy un tema y cómo quiero la respuesta.

Para probarla le escribí: «¿qué hay hoy en Hacker News?». Y después: «busca en HN algo de Rust».

No le dije que usara la skill. Leyó la descripción y la usó sola. Por eso la frase «Úsala cuando pida noticias de tech, qué hay en HN…» no es decoración: es lo que dispara todo.

Skill 2: mensaje-commit

No me gusta escribir mensajes de commit. Cuando voy con prisa terminan siendo «fix» o «cambios», y seis meses después no sirven para nada. El archivo:

---
name: mensaje-commit
description: Escribe el mensaje de commit de lo que tengo en staged. Úsala cuando diga commit o pregunte qué pongo en el commit.
---

Mira `git diff --staged`. Si no hay nada, dímelo y para.
Mira mis últimos commits con `git log --oneline -10` y copia mi estilo.
Una línea corta; añade cuerpo solo si el cambio no se entiende solo.

Enséñame el mensaje antes de hacer el commit.

Hay dos líneas que importan.

La del git log. En vez de explicarle mi estilo, le digo que lo copie de mis commits. Mi estilo ya está escrito en el historial; describirlo a mano sería peor y se desactualizaría.

La última. Me enseña el mensaje antes de commitear. Una skill puede hacer cosas, pero yo decido cuándo.

La probé de las dos formas: con /mensaje-commit y preguntando «¿qué pongo en el commit?».

Instalarlas

Copia cada carpeta a ~/.claude/skills/, o a .claude/skills/ dentro de tu repo si quieres compartirlas con el equipo:

mkdir -p ~/.claude/skills/hackernews ~/.claude/skills/mensaje-commit
cp hackernews/SKILL.md ~/.claude/skills/hackernews/
cp mensaje-commit/SKILL.md ~/.claude/skills/mensaje-commit/

Tres lecciones

Una descripción vaga no dice cuándo. «Ayuda con git» no le dice a Claude en qué momento usar la skill. Di cuándo, con las palabras que tú usas: «cuando diga commit», «cuando pregunte qué pongo en el commit».

Mientras más corta, mejor la sigue. Las mías tienen unas diez líneas. Si te cuesta resumirla, probablemente sobra algo.

Una skill, una tarea. Si una skill hace dos cosas, son dos skills.

Lo que me llevo

Dos archivos de unas diez líneas cada uno. Piensa en lo que le repites a Claude cada semana: esa es tu próxima skill.

Cuéntame en los comentarios del video cuál vas a crear primero, o comparte la tuya si ya la tienes.