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.

Guía paso a paso5 min de lecturaPor Rafael Schwart

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:

  1. ¿Qué dispara la tarea? Un correo, un pedido, el lunes a las 9.
  2. ¿Qué datos necesita y dónde están?
  3. ¿Cuáles son los pasos, en orden?
  4. ¿Cómo se ve un resultado bien hecho?
  5. ¿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

TipoRutaPara quién
Personal~/.claude/skills/responder-cotizaciones/SKILL.mdTú, en todos tus proyectos
Del proyecto.claude/skills/responder-cotizaciones/SKILL.mdQuien 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

  1. Abre una sesión en la carpeta del proyecto. Si la carpeta skills/ no existía cuando abriste la sesión, escribe /reload-skills o reinicia. Si ya existía, Claude Code toma tus cambios sin reiniciar.
  2. Llámalo directo. Escribe /responder-cotizaciones y pega un pedido real, sin datos personales del cliente. Revisa que siga cada paso.
  3. 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.
  4. Prueba un caso que no debe activarlo. Pega un reclamo, por ejemplo. Si se activa, haz la descripción más específica.
  5. 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.

Empieza con un solo proceso, el más frecuente. Usa el skill dos semanas, anota dónde se equivoca y corrige el SKILL.md. Es el mismo ciclo con que se mejora cualquier procedimiento: hacer, medir, ajustar.

Sigue leyendo

Más guías.

Cada una se lee en menos de cinco minutos.

Todas las guías
Guía paso a paso · 4 min

Claude Code desde cero

Qué es Claude Code, cómo instalarlo en Windows o Mac, tu primer pedido, cómo aprobar lo que hace y los comandos que vas a usar cada día.

Guía paso a paso · 4 min

CLAUDE.md: el manual de tu proyecto

Qué es el archivo CLAUDE.md, dónde va, cómo crearlo con /init y qué escribir para que Claude no te pregunte lo mismo en cada sesión.

  Arqentia

¿Prefieres que lo armemos contigo?

Treinta minutos para ver tu operación: cómo entra el dinero, dónde se pierde tiempo y qué conviene automatizar primero. Gratis para negocios y sin compromiso.

Agendar consulta