El molde de una skill

El esqueleto de un SKILL.md con un ejemplo lleno, el prompt que le pide a Claude Code que fabrique la skill de una tarea tuya, y dónde va el archivo para que Claude la encuentre sola.

Para qué sirve

Una skill es una tarea que Claude hace igual cada vez sin que se la expliques. Si hay algo que le pides más de dos veces a la semana con las mismas instrucciones, es una skill.

El esqueleto

---
name: nombre-en-minusculas-con-guiones
description: Una línea que dice QUÉ hace y CUÁNDO usarla (Claude la lee para decidir si aplica).
---
# Qué recibe
Lo que el usuario pega o escribe después del comando. Si falta algo, pídelo antes de empezar.

# Qué lee antes
Los archivos que siempre tiene que leer (por ejemplo CONTEXTO.md).

# Reglas
Las 3 a 7 reglas que no se negocian. Con la condición adentro («si X, entonces Y»), no en párrafos aparte.

# Salida
El formato exacto: tabla, lista, archivo. Con un ejemplo corto.

# Lo que NO hace
Para que no se meta en lo que no le toca.

Un ejemplo lleno

---
name: resumen-de-llamada
description: Convierte la transcripción de una llamada de ventas en la ficha del lead: situación, dolor, objeciones, siguiente paso. Úsala después de cada llamada.
---
# Qué recibe
La transcripción completa. Si es un resumen y no la transcripción, avísalo y trabaja con lo que hay.
# Qué lee antes
CONTEXTO.md (para saber qué vendemos y qué objeciones son típicas).
# Reglas
Cita textual cuando digas qué dijo la persona; nunca parafrasees una objeción. Si no dijo el presupuesto, escribe «no lo dijo», no lo estimes. El siguiente paso es UNO, con fecha.
# Salida
Tabla de 5 filas: situación, objetivo, dolor real (con la cita), objeciones (con la cita), siguiente paso.
# Lo que NO hace
No escribe el mensaje de seguimiento: eso lo hace /seguimiento.

El prompt que fabrica una skill de una tarea tuya

Quiero convertir esta tarea en una skill: [describe la tarea como se la explicarías a alguien nuevo, con un ejemplo de entrada y de salida].
Escribe el SKILL.md con el esqueleto: metadatos (name, description de una línea con qué y cuándo), qué recibe, qué lee antes, reglas (con la condición adentro), salida con ejemplo, lo que NO hace.
Antes de escribirlo, hazme las 3 preguntas cuya respuesta cambiaría la skill.

Dónde va el archivo

.claude/skills/<name>/SKILL.md dentro del proyecto (solo ahí) o en ~/.claude/skills/<name>/SKILL.md (en todos tus proyectos). Claude la lista y la invoca con /<name>.

Qué NO resuelve

Una skill no aprende: hace lo que dice el archivo. Si la salida sale mal, se corrige el archivo, no se repite el pedido.

Siguiente paso

«El índice de habilidades del agente» es la página que le dice a Claude cuándo usar cada skill sin que se lo pidas.