Tu primera skill de Claudeenséñale una vez cómo haces algo y que lo haga solo cada vez que hace falta

01 el punto de partida

Qué es y cuándo conviene

Una skill vive en una carpeta, y adentro lo que manda es un archivo: SKILL.md. Ese archivo tiene dos partes: un encabezado con el nombre y la descripción, y abajo las instrucciones escritas en español normal, como se las darías a alguien que entra a trabajar contigo. Nada de código.

La diferencia con escribir las instrucciones en el chat es cuándo se leen. Lo que pones en el chat se lee siempre y ocupa lugar en cada mensaje. Una skill se queda esperando: Claude solo ve su nombre y su descripción, y hasta que la tarea aparece, entra y lee el resto. O sea que puedes tener veinte skills largas sin que ninguna te esté costando nada mientras no hagan falta.

02 cómo funciona por dentro

La carga en tres niveles

Entender esto ahorra la mitad de los problemas después, porque explica por qué la descripción pesa tanto y por qué el cuerpo puede ser largo sin culpa:

Qué lee y cuándo

1. Nivel 1 — Siempre: solo el nombre y la descripción de cada skill que tengas. Es una lista de títulos. Con esto decide si alguna aplica.
2. Nivel 2 — Si aplica: entra y lee el SKILL.md completo, con todas tus instrucciones.
3. Nivel 3 — Si le hace falta más: abre los archivos de apoyo que hayas dejado en la carpeta, y solo el que necesite.

De aquí sale la consecuencia que importa: la decisión de usar tu skill se toma en el nivel 1, leyendo una sola línea. Puedes tener las mejores instrucciones del mundo en el nivel 2 y no van a servir de nada si la línea del nivel 1 no le dijo que entrara.

03 la idea central

La descripción es el gatillo

Casi todas las descripciones se escriben como si fueran el nombre de una opción en un menú: 'Genera cotizaciones profesionales'. Suena bien y no dispara nunca, porque tú no dices 'genera una cotización profesional'. Tú dices 'cuánto le cobro a este cliente'. Y esa frase no se parece a la descripción, así que Claude no la relaciona.

La descripción tiene que traer las frases que de verdad dices, con tus palabras y tus muletillas. La fórmula que funciona es: primero qué hace en una frase, después la palabra 'usa cuando' y una lista de frases tuyas entre comillas.

description: "Arma una cotización con el formato y los precios del negocio. Usa cuando se mencione: cuánto le cobro, arma la cotización, mándale precio, cotízale esto, cuánto sale, precio para el cliente."

• Escríbelas como las dices tú. Si sueles decir 'mándale precio', pon 'mándale precio', no 'enviar propuesta económica'.
• Mete las variantes. Cada frase distinta es una puerta más por la que puede entrar.
• Incluye también el problema, no solo la acción: 'no sé cuánto cobrar' es un gatillo tan bueno como 'arma la cotización'.
• Escríbela hablando de la skill, no en primera persona: 'arma una cotización', no 'yo armo cotizaciones'.

04 manos a la obra

Vamos a hacer una completa

Una skill de cotizaciones, que sirve tanto si vendes servicios como si vendes producto. Son dos pasos: crear la carpeta y escribir el archivo. Si nunca has usado la terminal, pídele a Claude que corra estos comandos por ti y ya.

mkdir -p ~/.claude/skills/cotizar

---
name: cotizar
description: "Arma una cotización con el formato y los precios del negocio. Usa cuando se mencione: cuánto le cobro, arma la cotización, mándale precio, cotízale esto, cuánto sale, no sé cuánto cobrar."
---

# Cotizar

## Antes de escribir nada

Pregunta lo que falte, de una en una, empezando por lo que más cambia el precio:

1. Qué pidió el cliente, con sus palabras
2. Para cuándo lo quiere
3. Si ya trabajamos con él antes
4. Si hay algo fuera de lo normal (viajes, prisa, permisos, terceros)

Si ya tienes la respuesta en la conversación, no la vuelvas a preguntar.

## Cómo se calcula

- El precio se arma por horas estimadas, no por proyecto cerrado.
- Estima las horas por etapa y súmalas. Si una etapa te da más de 20 horas,
  pártela: significa que todavía no está entendida.
- A la suma agrégale un 15% de holgura y dilo abiertamente en la cotización.
- Prisa (menos de una semana): 25% encima.
- Cliente que ya trabajó con nosotros: sin recargo de prisa.

## Cómo se escribe

- Una sola cifra grande al final. Nada de rangos: un rango se lee como que no sabemos.
- Las etapas son el calendario de entrega, no un menú para escoger.
- Español de México, de tú, sin adjetivos sobre nosotros.
- Di qué NO incluye. Es lo que evita la discusión del mes tres.
- Máximo una página.

## Qué no hacer

- No ofrecer descuento sin que lo pidan.
- No inventar plazos: si no sabes cuánto tarda algo, márcalo como pendiente
  de confirmar en vez de estimarlo.
- No prometer nada que dependa de un tercero sin decir que depende de un tercero.

## Al terminar

Muestra la cotización y aparte, para mí y no para el cliente, dime en dos líneas
qué supusiste y qué es lo que más podría cambiar el precio.

Fíjate en lo que hace ese archivo y que no tiene nada de técnico: fija un método de cálculo, un formato de salida, una lista de lo que no se hace, y al final pide que te avise de sus propias suposiciones. Es lo que le explicarías a alguien que llega a ayudarte con las cotizaciones. Cambia los criterios por los tuyos y ya tienes la tuya.

05 lo que nadie comprueba

Probar que dispara

Una skill que no se dispara es una skill que no existe, y como no da ningún error, uno se entera meses después. Son dos minutos comprobarlo:

La prueba

1. Abre una conversación nueva. En la que ya venías trabajando no sirve, porque la lista de skills se lee al arrancar.
2. Escribe una de las frases de tu descripción tal cual la dirías, sin nombrar la skill. Por ejemplo: 'oye, cuánto le cobro a este cliente por un rediseño de su tienda'.
3. Mira si la usa. Si empieza haciéndote las preguntas del archivo en vez de contestar de corrido, entró.
4. Si no entró, prueba con otra de tus frases. Si con ninguna entra, el problema está en la descripción, no en el cuerpo.

06 cuando ya la usas

Cómo crece sin engordar

La tentación después de dos semanas es irle agregando casos al SKILL.md hasta que son quinientas líneas y ya nadie sabe qué dice. La forma de crecer sin eso es el nivel 3: los archivos de apoyo. Se quedan en la carpeta y solo se abren cuando hacen falta.

~/.claude/skills/cotizar/
├── SKILL.md          # el método y los criterios — corto
├── PRECIOS.md        # tarifas por tipo de trabajo
├── EJEMPLOS.md       # dos cotizaciones que salieron bien
└── PLANTILLA.md      # el formato exacto de salida

En el SKILL.md los mencionas con una línea del tipo 'las tarifas están en PRECIOS.md; consúltalo antes de calcular'. Así el archivo principal se queda corto y legible, y el detalle solo se carga el día que se usa. Como regla, si el SKILL.md pasa de unas quinientas líneas, ya hay algo que debería ser un archivo aparte o una segunda skill.

• Los ejemplos de resultados buenos valen más que las instrucciones: uno bien elegido corrige más que tres párrafos de reglas.
• Cuando encuentres un error que se repite, no reescribas todo — agrega una línea en 'qué no hacer'. Esa sección es la que más rinde con el tiempo.
• Si la skill empieza a hacer dos cosas distintas, pártela en dos. Se disparan mejor por separado.