Al terminar este módulo, vas a crear tu primer skill: una chamba tuya que Claude hará igual de bien todas las veces.
Con este módulo arranca el arco de los superpoderes. En el módulo 5 conociste los cuatro cajones de la oficina de tu empleado (~/.claude): el contrato, la constitución, la nómina y el recetario. Ya escribiste tu constitución. Hoy abrimos el segundo cajón: el recetario (skills/). Los otros dos — el contrato a fondo y la nómina — son los módulos 8 y 9.
Piensa en la chamba que le explicaste a Claude esta semana. El lunes le dictaste cómo te gusta el resumen de ventas: qué carpeta leer, qué va primero, qué formato, qué tono. Salió bien. El miércoles se lo volviste a explicar. El viernes, otra vez. Cada vez tecleas el mismo choro de diez líneas — y cada vez sale casi igual, porque cada vez lo explicaste casi igual.
Tu primer instinto va a ser meterlo todo a la constitución (módulo 5). Frena. La constitución se carga COMPLETA en cada sesión, aunque esa sesión no tenga nada que ver con reportes — y la documentación oficial es tajante con eso: un CLAUDE.md inflado hace que Claude ignore tus instrucciones de verdad ("Bloated CLAUDE.md files cause Claude to ignore your actual instructions!"). La constitución es para lo que aplica SIEMPRE; los procedimientos de una chamba específica van en otro lado.
Un skill es la receta de la casa. En una fonda, la sazón de la cocinera no se explica cada día: está en el recetario — ingredientes, pasos, punto exacto. Cualquier día, cualquier turno, el mole sale igual. Un skill (receta/habilidad) es eso: cómo se hace UNA chamba tuya, paso a paso, escrita una sola vez. Claude la saca del cajón cuando la ocasión lo pide — y la chamba sale con TU sazón todas las veces.
La regla de dedo para saber si algo es receta y no constitución: si tu instrucción empieza con "cada vez que te pida X…", es un skill. "Contéstame siempre en español" → constitución (aplica a todo). "Cada vez que te pida el reporte semanal, hazlo así…" → receta (aplica a UNA chamba).
Una receta vive en el cajón del recetario: una carpeta con el nombre de la chamba dentro de ~/.claude/skills/, y adentro un archivo llamado SKILL.md. Eso es todo el esqueleto:
~/.claude/skills/
└── reporte-semanal/
└── SKILL.mdEl SKILL.md tiene dos partes. Arriba, entre dos líneas de guiones, va la etiqueta de portada (en inglés: frontmatter): el nombre de la receta y — la parte que más importa — la description: una o dos frases que le dicen a Claude CUÁNDO usar esta receta. Abajo van los pasos, en español normal.
Así se ve una receta completa por dentro (esta la escribió Claude a dictado — tú nunca vas a teclear esto a mano):
---
name: reporte-semanal
description: Arma el reporte semanal del negocio juntando los archivos de la semana. Úsala cuando pida "mi reporte semanal", "resumen de la semana" o "junta la semana".
---
Eres el responsable del reporte semanal. Cuando te lo pidan:
1. Lee todos los archivos de la carpeta que te indiquen
(si no me dicen cuál: ~/Curso-Claude/archivos-semana/).
2. Agrupa lo que encuentres en tres temas: ventas, clientes, pendientes.
3. Escribe `reporte-semana.md` con este formato EXACTO:
- **Resumen ejecutivo** — 3 líneas máximo.
- **Números de la semana** — en tabla.
- **Pendientes** — lista con responsable y fecha.
4. Tono directo, en español, sin adornos. Números, no adjetivos.Fíjate en la description: no describe qué ES la receta, describe cuándo DISPARA — incluye hasta las frases con las que la vas a pedir. Esa description es el gatillo: Claude la lee para decidir si la ocasión amerita sacar esta receta del cajón. Description vaga = receta que duerme en el cajón para siempre.
El slash command es el timbre. ¿Te acuerdas de los slash commands del módulo 1 (/help, /model)? Cada receta tuya estrena el suyo: tecleas /reporte-semanal y la receta arranca directo, sin rodeos. Dos formas de despertar a la misma receta: pedirla con tus palabras (el gatillo de la description decide) o tocar el timbre (/nombre, directo y sin ambigüedad).
Para ver tu recetario completo — las recetas tuyas y las que vienen de fábrica — hay un comando:
Teclea (o pega) esto (dentro de Claude Code):
/skillsVas a ver algo así:
Available skills:
reporte-semanal — Arma el reporte semanal del negocio…
(+ los skills que vienen incluidos con Claude Code)Qué significa: el recetario está abierto: cada línea es una receta disponible, con su gatillo. Si la tuya aparece, existe y está lista.
Si en vez de eso ves que tu receta no aparece: revisa dos cosas con Claude — que la carpeta esté dentro de ~/.claude/skills/ y que el archivo se llame exactamente SKILL.md. Pídeselo así: "revisa por qué mi skill reporte-semanal no aparece en /skills".
Aquí viene la mejor noticia del módulo: tú NO escribes el archivo. Se lo dictas a Claude — "quiero un skill que haga X, se dispara cuando yo diga Y, el resultado se ve así" — y él escribe su propia receta en el cajón correcto, con el formato correcto. Tú decides la receta; él la redacta. Es el mismo patrón de todo el manual: tú describes, él construye.
La guía oficial de Anthropic para quien diseña herramientas de agentes da el consejo exacto que necesitas al dictar: describe cada pieza "como si entrenaras a un empleado nuevo". No "haz un reporte bonito" sino: qué lee, qué agrupa, qué escribe, en qué orden, con qué tono. Todo lo que dirías el primer día a una persona nueva en ese puesto — eso va en la receta.
Y el ciclo de calidad es el de cualquier receta de cocina: probar → afinar → probar. La primera corrida casi nunca sale al punto. En vez de corregir el resultado a mano, corrige LA RECETA: "quedó bien, pero el resumen me lo das en 3 líneas, no en 10 — actualiza el skill". La corrección se guarda en el archivo, y la siguiente corrida ya nace corregida. Corregir el resultado arregla UNA vez; corregir la receta arregla TODAS las que vienen.
Síntoma: "Creé el skill, se lo pido con mis palabras… y me hace la chamba a su manera, sin la receta."
Causa: la description es el gatillo, y la tuya no menciona las frases con las que TÚ pides la chamba. Claude no adivinó que "ármame el resumen de la semana" era lo mismo que "reporte semanal".
Salida: dale mantenimiento al gatillo: "actualiza la description de mi skill reporte-semanal para que también dispare cuando diga 'resumen de la semana' o 'cómo nos fue'". Mientras afinas, usa el timbre (/reporte-semanal) — ese no falla porque no depende de interpretación.
Síntoma: "Metí mis diez procedimientos a la constitución y ahora Claude se salta reglas que antes respetaba."
Causa: el documento-basurero del módulo 5: la constitución inflada entierra las reglas importantes en el ruido — está documentado que un CLAUDE.md sobrecargado hace que Claude ignore instrucciones.
Salida: saca los procedimientos a recetas: pídele a Claude "revisa mi CLAUDE.md: todo lo que sea un procedimiento de una chamba específica ('cada vez que te pida X'), conviértelo en skill y déjame la constitución solo con las reglas que aplican siempre". Corre /skills al final para ver tu recetario nuevo.
Un skill paga cuando la chamba cumple dos condiciones: la haces 3 veces o más, y los pasos son estables (el proceso no cambia cada vez, solo cambian los datos). Reporte semanal, cotización, checklist de cierre de mes, formato de minuta: recetas perfectas.
Cuándo NO: para la cosa de una sola vez. Si mañana necesitas un análisis único de un contrato raro, pídelo y ya — escribir una receta para algo que no se repite es ordenar el cajón de un cuarto al que no vas a volver. Y tampoco para reglas universales ("siempre en español"): eso es constitución.
El mapa completo de "dónde vive cada cosa" quedó así — es el cierre de la frontera que abrimos en el módulo 5:
| Dónde vive | Qué guarda | Ejemplo |
|---|---|---|
| Constitución (CLAUDE.md) | Lo estable que aplica SIEMPRE | "Pregunta antes de borrar", tu tono, tus clientes |
| Libreta (memoria) | Hechos que evolucionan | "El proveedor cambió de banco en marzo" |
| Recetario (skills/) | Procedimientos de UNA chamba | "Cada vez que pida el reporte semanal…" |
Y en el módulo 9 se abre el cajón que falta: cuando ni la receta alcanza porque la chamba necesita otro par de manos, se contrata a otro empleado. Eso viene pronto.
En SmartProcess, el recetario es la línea de producción de la agencia. Tres recetas reales:
/aprender — a las recetas más usadas se les pone un timbre breve, aunque el nombre formal sea más largo.Dos costumbres de la casa que valen oro: primera, las descriptions llevan las frases textuales que las despiertan ("se activa si dices: 'cuánto le cobro a…', 'qué le mando al cliente nuevo…'") — por eso disparan a la primera. Segunda, la convención de nombres de la constitución: el nombre dice de quién es la pieza y qué hace, no qué tipo es — smartprocess-cotizador, no "skill-de-cotizaciones-v2". Con decenas de recetas en el cajón, los nombres claros son la diferencia entre un recetario y un tiradero.
Qué vas a lograr: tu primer skill real funcionando: una chamba tuya que hoy explicas cada vez, convertida en receta que sale igual todas las veces. Saca tu organigrama del módulo 0 y elige una tarea de la columna "reportes" o "archivos" — o usa una de estas dos, que vienen con seed:
Qué necesitas: Claude Code y, si eliges el reporte, la carpeta de práctica ejercicios/m07/archivos-semana/ (viene con los materiales del curso: son los documentos de una "semana" de un negocio ficticio). En ejercicios/m07/skill-ejemplo/ hay además un SKILL.md mínimo de referencia por si quieres comparar el tuyo.
Pasos:
archivos-semana dentro de ~/Curso-Claude/ (arrástrala, o dile a Claude dónde tienes los materiales del curso y que te la copie él).~/Curso-Claude/ y díctale la receta — pega esto y ajústalo a tu gusto:Quiero crear un skill llamado reporte-semanal. Cada vez que te pida "mi reporte semanal" o "resumen de la semana": lee los archivos de ~/Curso-Claude/archivos-semana/, agrupa lo que encuentres en ventas / clientes / pendientes, y escribe reporte-semana.md con: resumen ejecutivo de 3 líneas, números de la semana en tabla, y pendientes con responsable. Escribe tú el SKILL.md en mi carpeta de skills y enséñamelo antes de guardarlo.
(Para el cotizador-mini es igual: dale tus 3 servicios con precios y el formato de la cotización que quieres.)
Teclea (o pega) esto (dentro de Claude Code):
/skillsVas a ver algo así:
Available skills:
reporte-semanal — Arma el reporte semanal del negocio…Qué significa: tu receta ya está en el cajón y con el gatillo puesto.
Si en vez de eso ves que no aparece: pídele a Claude "revisa por qué mi skill no sale en /skills" — lo típico es carpeta fuera de ~/.claude/skills/ o el archivo con otro nombre.
Teclea (o pega) esto (dentro de Claude Code):
/reporte-semanalVas a ver algo así:
● Ejecutando skill: reporte-semanal
Leyendo archivos-semana/… (6 archivos)
Escribiendo reporte-semana.md…Qué significa: la receta está corriendo: primero lee, luego escribe — el ciclo del empleado del módulo 2, pero siguiendo TUS pasos.
Si en vez de eso ves que hace la chamba "a su manera": abre el reporte-semana.md, apunta qué NO salió con tu formato, y pasa al paso 5 — para eso es.
/clear, mesa limpia — así compruebas que la receta no depende de la plática) y pídela con tus palabras, sin timbre: "ármame el resumen de la semana". Compara contra la primera.¿LO LOGRASTE?
/skills lista tu receta con su description.skill — la receta de la casa: instrucciones empaquetadas para UNA chamba, que Claude ejecuta igual todas las veces.
SKILL.md / frontmatter — el archivo de la receta y su etiqueta de portada: el nombre y la description (el gatillo que le dice a Claude cuándo usarla).
La demo de 5 minutos: pide a la sala una chamba repetitiva real (siempre sale una: "el reporte para mi jefe"). Díctale el skill a Claude EN VIVO, córrelo, y luego el remate: ciérrales la sesión, abre una nueva y córrelo otra vez con otras palabras — mismo formato, cero explicaciones. "Se lo expliqué UNA vez, ya salió DOS" es el momento en que compran la idea.
El error que el alumno VA a cometer: description vaga ("hace reportes") → la pide con sus palabras → no dispara → "no sirve". Capitalízalo: enséñales el gatillo, agreguen juntos las frases reales del alumno a la description, y que dispare a la siguiente. La lección queda sola: la receta es tan buena como su gatillo.
La pregunta de arranque: "¿Qué chamba explicaste esta semana por tercera vez — a una persona o a una IA?"
Verificado contra documentación oficial el 2026-07-12.