Directorio / Guías / Claude Code
Cómo crear tu propio skill
Convierte un proceso que repites cada semana en un skill: la carpeta, el SKILL.md, la descripción que decide cuándo se usa, los archivos de apoyo y cómo probarlo.
Si cada semana le pegas a Claude las mismas instrucciones, ya tienes un skill escrito, solo que vive en tu portapapeles. Un skill es una carpeta con un archivo SKILL.md que le enseña a Claude a hacer un trabajo a tu manera. Claude lo usa cuando tu pedido coincide con su descripción, o cuando tú lo llamas con /nombre-del-skill.
Primero el proceso
Un skill no arregla un proceso confuso: lo repite. Antes de escribir nada, responde en una hoja:
- ¿Qué dispara la tarea? Un correo, un pedido, el lunes a las 9.
- ¿Qué datos necesita y dónde están?
- ¿Cuáles son los pasos, en orden?
- ¿Cómo se ve un resultado bien hecho?
- ¿Qué no debe pasar nunca?
Si puedes contestar las cinco, el skill casi se escribe solo.
La estructura
responder-cotizaciones/
├── SKILL.md las instrucciones (obligatorio)
├── precios.md lista de precios vigente
└── plantilla.md formato de la respuesta
El SKILL.md lleva arriba un encabezado entre dos líneas --- y, debajo, las instrucciones en texto normal. Los archivos de apoyo no se cargan todo el tiempo: Claude los abre cuando el skill los menciona y los necesita.
El encabezado
name: el comando que escribes después de la barra. Si no lo pones, se usa el nombre de la carpeta. Usa minúsculas y guiones.description: qué hace y cuándo usarlo. Es el campo que más importa.
En Claude Code solo la descripción es recomendada, pero conviene poner los dos. Si algún día subes el skill a la app de Claude, ahí solo se aceptan unos pocos campos del estándar abierto de skills, entre ellos estos dos.
Si el skill hace algo con consecuencias, como enviar un correo, agrega disable-model-invocation: true. Así solo corre cuando tú lo llamas.
Por qué la descripción decide cuándo se usa
Claude no lee todos tus skills en cada mensaje. Tiene a la vista solo sus descripciones, y carga el contenido completo del que coincide con lo que pediste. Una descripción vaga no se activa nunca, o se activa cuando no debe.
- Pon primero el caso de uso principal. Si la descripción es muy larga, se corta en la lista.
- Usa las palabras con que de verdad pides la tarea: cotización, presupuesto, cuánto cuesta.
- Di cuándo no usarlo si se parece a otro de tus skills.
«Ayuda con clientes» es vaga. «Redacta respuestas a pedidos de cotización usando la lista de precios vigente» dice qué hace y cuándo.
Ejemplo completo: responder cotizaciones
El archivo SKILL.md:
---
name: responder-cotizaciones
description: Redacta la respuesta a un pedido de cotización usando la lista de precios vigente. Úsalo cuando el usuario pegue un correo o mensaje de un cliente que pide precio, presupuesto o cotización.
---
# Responder cotizaciones
## Pasos
1. Lee el mensaje del cliente e identifica productos, cantidades,
lugar de entrega y fecha en que los necesita.
2. Busca cada producto en precios.md. Si un producto no está en la
lista, no inventes un precio: márcalo como "por confirmar".
3. Calcula el subtotal de cada línea, el descuento por volumen según
precios.md y el total. Muestra el cálculo.
4. Redacta la respuesta con el formato de plantilla.md.
5. Al final, fuera del texto para el cliente, lista lo que falta
confirmar con el cliente o con el equipo.
## Reglas
- Tono cordial y directo, de tú, sin frases de relleno.
- Precios sin impuestos, y dilo en la respuesta.
- La cotización vale por 15 días.
- Nunca prometas una fecha de entrega: escribe "a confirmar según stock".
- No envíes nada. Solo redacta el borrador para que una persona lo revise.
## Archivos de apoyo
- Lista de precios y descuentos: [precios.md](precios.md)
- Estructura de la respuesta: [plantilla.md](plantilla.md)
En precios.md va tu tabla de productos, precio unitario y descuentos. En plantilla.md, el saludo, el detalle, las condiciones y la firma. Cuando cambian los precios, actualizas un solo archivo y el skill usa los nuevos la próxima vez, sin tocar las instrucciones.
Dónde guardarlo
| Tipo | Ruta | Para quién |
|---|---|---|
| Personal | ~/.claude/skills/responder-cotizaciones/SKILL.md | Tú, en todos tus proyectos |
| Del proyecto | .claude/skills/responder-cotizaciones/SKILL.md | Quien trabaje en ese proyecto. Súbelo a git para compartirlo. |
En Windows, ~ es tu carpeta de usuario: C:\Users\tu-usuario\.claude\skills\.
Pruébalo
- Abre una sesión en la carpeta del proyecto. Si la carpeta
skills/no existía cuando abriste la sesión, escribe/reload-skillso reinicia. Si ya existía, Claude Code toma tus cambios sin reiniciar. - Llámalo directo. Escribe
/responder-cotizacionesy pega un pedido real, sin datos personales del cliente. Revisa que siga cada paso. - Pruébalo sin nombrarlo. En una sesión nueva, pega otro pedido y escribe solo «Respóndele a este cliente». Si no lo usa, a la descripción le faltan las palabras que tú usas.
- Prueba un caso que no debe activarlo. Pega un reclamo, por ejemplo. Si se activa, haz la descripción más específica.
- Compara. Corre el mismo pedido con el skill y sin él. Si el resultado no mejora, el skill todavía no aporta.
Con /skills ves la lista de los que tienes. Para pruebas más ordenadas, el skill Skill creator del directorio arma casos de prueba y compara versiones. Si quieres instalar skills de otros, sigue la guía Cómo instalar un skill en Claude.