Creá tu primera skill en 20 minutos

En este tutorial vas a crear una skill de Claude funcionando de punta a punta: la carpeta, el archivo de instrucciones y la prueba real que confirma que se dispara. Es para vos si ya sabés qué es una skill y querés dejar de repetirle las mismas instrucciones a la IA. Vamos a trabajar en Claude Code, la versión de terminal.

Antes de empezar

• Claude Code instalado y con tu sesión iniciada (necesita plan de pago o créditos de API; mejor saberlo de entrada).
• Saber abrir una terminal y copiar un comando. Nada más.
• Una tarea que repetís seguido y con reglas claras. Mi ejemplo: el reporte mensual para clientes.
• 20 minutos sin interrupciones.

Paso 1 — Elegí bien la tarea (acá se gana o se pierde)

La skill ideal para arrancar cumple tres condiciones: la hacés seguido, siempre sigue las mismas reglas, y hoy le explicás esas reglas a Claude a mano cada vez. Malos candidatos: tareas creativas donde cada vez querés algo distinto, o procesos que ni vos tenés claros.

Antes de tocar la terminal, escribí en un papel:

1. Con qué palabras pedís esa tarea ("armame el reporte de junio de la ferretería").
2. Las reglas que siempre terminás repitiendo.
3. Cómo se ve un resultado bien hecho.

Ese papel ES tu skill. Lo demás es formato.

Paso 2 — Creá la carpeta y el archivo

Tus skills personales viven en .claude/skills, dentro de tu carpeta de usuario, una subcarpeta por skill. En la terminal:

mkdir -p ~/.claude/skills/reporte-cliente

Adentro creá un archivo llamado exactamente SKILL.md, con cualquier editor de texto. Podrías pedirle a Claude Code que haga esto por vos — pero hacerlo a mano una vez te enseña dónde vive cada cosa, y eso paga después.

Paso 3 — Escribí la ficha (la parte que más importa)

Las primeras líneas del SKILL.md son la ficha entre guiones: nombre y descripción.

---
name: reporte-cliente
description: Redacta el reporte mensual de resultados para un cliente
  de marketing. Usar cuando pida "reporte de [cliente]", "resumen del
  mes" o algo parecido sobre métricas y resultados.
---

Dos reglas de oro:

• Nombre: corto, en minúsculas, con guiones. Es el identificador.
• Descripción: qué hace + cuándo usarla, escrita con las palabras que VOS usás al pedir la tarea. Claude solo lee esto para decidir si abre la skill: es el gatillo. Una descripción vaga es una skill muerta.

Paso 4 — Escribí las instrucciones como si entrenaras a alguien nuevo

Debajo de la ficha van las instrucciones. Imaginate que entrenás a una persona nueva en tu equipo, capaz pero que no conoce tu negocio:

# Reporte mensual de cliente

## Pasos
1. Si no está claro, preguntá de qué cliente y de qué mes es.
2. Pedí las métricas del mes: alcance, interacciones, consultas o ventas.
3. Armá el reporte con esta estructura:
   - Resumen en 3 frases, lenguaje simple, sin jerga.
   - Qué funcionó y qué no, con números concretos.
   - 3 acciones recomendadas para el mes que viene.

## Reglas
- Tono profesional pero cercano; el cliente no es técnico.
- Nunca prometer resultados futuros; recomendar, no garantizar.
- Si un número empeoró, decirlo directo y explicar el porqué probable.

Truco que vale doble: guardá un reporte que te quedó bueno como ejemplo.md en la misma carpeta y agregá la línea "seguí el formato de ejemplo.md". Nada enseña formato mejor que un ejemplo real.

Paso 5 — Probala en una sesión nueva

Abrí una sesión nueva de Claude Code y pedí la tarea con tus palabras de siempre, sin mencionar la skill:

armame el reporte de junio de la ferretería

Verificá dos cosas: que Claude usó la skill (lo vas a ver en la respuesta) y que el resultado respeta tus reglas.

• ¿No se activó? Casi siempre es la descripción. Reescribila con las palabras exactas que usaste al pedir.
• ¿Se activó pero salió flojo? Son las instrucciones. Agregá la regla que faltó y probá de nuevo.

Dos o tres rondas de ajuste es lo normal; nadie escribe la skill perfecta a la primera.

Errores comunes

• Descripción genérica ("ayuda con reportes"): la skill no se dispara nunca. Arreglo: qué hace + cuándo + palabras gatillo.
• SKILL.md kilométrico: si el archivo es una novela, Claude se pierde. Arreglo: instrucciones cortas en el SKILL.md, el detalle fino en archivos aparte dentro de la carpeta.
• Datos sensibles adentro: nada de contraseñas, claves de API ni datos privados de clientes. La skill es texto plano que viaja con tus pedidos. Arreglo: la skill describe el proceso; los datos se los pasás en el momento.
• Esperar que corra sola: una skill no es una automatización programada; guía a Claude cuando vos le pedís algo. Si querés que algo corra solo todos los días, eso se resuelve con otra herramienta.

Siguiente paso

Con la primera funcionando, hacé dos o tres más de tu lista de tareas repetidas: la segunda sale en la mitad del tiempo. Después explorá cómo sumar plantillas y scripts, cómo instalar skills de la comunidad, y el truco definitivo: pedirle a Claude que escriba y mejore tus skills por vos, con vos revisando. Ahí la bola de nieve empieza a girar sola.