Contenido detallado
🖐️ Empieza manualmente: hazlo a mano y después captura el proceso
La capa de Habilidades empieza de la manera menos obvia: a mano. Ejecutas la tarea de verdad por primera vez — a veces escribiendo durante una hora todo tu razonamiento sobre cómo abordar el problema — y solo después captura eso en una skill. La meta es simple: al final de esa sesión, no tener que repetir nunca más ese nivel de instrucción.
🌱 ¿Nuevo aquí?
Una skill (habilidad) es una tarea empaquetada para ejecutarse igual cada vez; piensa en un tarjeta de receta. En Claude Code suele convertirse en un slash command (un comando que empieza con una barra, por ejemplo: /monthly-review), guardado en un archivo SKILL.md dentro de la carpeta skills/ de tu OS. A veces "cocinas a ojo" y solo entonces escribes la receta.
Cómo leer: la skill no nace de la nada. Es el último paso de un camino que empieza haciendo la tarea a mano; por eso, una skill para algo que nunca has hecho queda genérica.
✓ Manual primero
- ✓Compruebas que la tarea funciona antes de empaquetarla.
- ✓La receta refleja los detalles reales que solo aparecen al hacerlo.
- ✓Sabes exactamente qué verificar al final.
✗ Skill fantasma
- ✗Escribir una skill sobre algo que nunca hiciste a mano.
- ✗Resultado genérico que falla en el primer caso real.
- ✗No tienes criterios para saber si funcionó.
Por qué aprender
Porque es lo que separa una skill viva de una skill muerta. Hacerlo primero a mano incorpora a tu contexto todos los detalles precisos —excepciones, orden de los pasos, qué verificar— que una skill inventada desde cero no tiene. Capturarlo después convierte ese trabajo en un activo que nunca vuelves a hacer.
Conceptos clave
🔁 Reverse meta-prompting
Después de hacer la tarea a mano, viene la captura. El mecanismo se llama reverse meta-prompting: en lugar de escribir tú la skill, le pides a la IA que destile la conversación que acaban de tener en un comando reutilizable. Escribir la receta después de cocinar, no antes.
🌱 ¿Nuevo aquí?
El "meta-prompting" común consiste en darle instrucciones a la IA. Reverse el meta-prompting invierte: la IA observa lo que ustedes ya hicieron juntos y extrae las instrucciones —el criterio, el orden, los cuidados— y las materializa en un archivo. Te conviertes en editor de una receta que la IA redactó a partir de tu propia acción.
💡 La idea clave
Pide siempre un slash command que acepta un argumento. Este argumento es una frase en lenguaje natural que enriquece lo que hace el comando: así, la misma skill sirve para varios casos sin que tengas que reescribirla. Por debajo, debe tener un SOP (procedimiento operativo estándar): exactamente qué sucede y en qué secuencia.
Por qué aprender
Porque es el atajo que transforma un esfuerzo único en una capacidad permanente. Sin reverse meta-prompting, cada tarea empieza desde cero. Con él, la primera ejecución manual "paga" por todas las siguientes, y además aprendes a estructurar la solicitud (destilar el criterio → materializar → aceptar el argumento).
Conceptos clave
♾️ La señal del infinito: una skill nunca se termina
Cuando tienes una V1 de la skill, la lanza (ship). Pero la capa de habilidades es la que más confunde: mucha gente cree que una skill «empieza y termina». No. Tiene un señal de infinito aquí. El autor mantiene una skill que perfecciona casi todos los días desde hace seis meses.
Cómo leer: no hay un «final» en la esquina derecha. La skill gira: se lanza, se usa, se hace la retrospectiva, se ajusta y se vuelve a usar. El símbolo ∞ en el centro es la clave: la skill está viva mientras la usas.
🔎 La excepción que se convierte en regla
Hay un caso en que la skill «termina»: cuando se activa 100% autónoma, siempre con la misma entrada y salida. Entonces surge la pregunta correcta: ¿esto todavía debería ser una skill o ya es un script determinístico? (Es el tema 5.)
Por qué aprender
Porque calibra las expectativas. Quien espera «terminar» una skill la abandona ante la primera dificultad y esta se deteriora. Quien entiende el ∞ vuelve, la ajusta y consigue una skill cada vez mejor: exactamente la mentalidad de «cultivar, no instalar» aplicada a la capa de acción.
Conceptos clave
🧪 Post mortem al final de la sesión (con rúbrica)
¿Cómo haces girar, en la práctica, el ∞ del tema anterior? Con un post-mortem al final de la sesión. Le preguntas a Claude Code: "con base en cómo fue esta sesión, ¿cómo — si corresponde — deberíamos ajustar la skill?". Y entregas una rúbrica: el criterio para decidir cuándo cambiar algo y cuándo dejarlo como está.
Por qué aprender — el post mortem en 4 pasos
Termina la sesión
Usaste la skill en una tarea real. Antes de cerrar, todavía está fresca en la memoria del contexto.
Pregunta el ajuste
"Dado cómo resultó, ¿deberíamos cambiar la skill? ¿Qué y por qué?" La IA propone ajustes puntuales.
Aplica la rúbrica
La rúbrica indica cuándo conviene hacer un cambio (error recurrente, paso faltante) y cuándo no (fue un caso aislado).
Persiste el aprendizaje
El ajuste se incorpora a la skill (o a una regla). La próxima vez, la skill ya funciona mejor.
💡 Por qué importa la rúbrica
Sin una rúbrica, la IA cambia la skill a la menor provocación, y acumulas cambios impulsivos que se contradicen. La rúbrica pone el freno: solo cambia cuando el criterio lo justifica. Puede parecer demasiado meticuloso, y hay otras formas de evaluar, pero es lo que mantiene estable la skill.
Conceptos clave
⏰ Skill vs. tarea programada (cron)
No todo lo que se repite debe ser una habilidad. Si algo se ejecuta 100% autónomo — misma entrada, misma salida, sin criterio — quizá debería ser un script determinista (un Python o JavaScript que la propia IA escribe), posiblemente ejecutado por un cron.
🌱 ¿Nuevo aquí?
Un cron (o «trabajo programado») es un reloj del sistema que ejecuta un comando automáticamente a una hora fija; por ejemplo, todos los lunes a las 8h. Determinista significa: dada la misma entrada, siempre la misma salida, sin que la IA "decida". Es lo opuesto a una skill que requiere criterio en cada uso.
✓ Déjala como skill cuando
- ✓Cada uso requiere algo de criterio o contexto nuevo.
- ✓El argumento cambia lo que hace cada vez.
- ✓Todavía estás afinando el proceso.
→ Conviértelo en script/cron cuando
- →Se activa de forma 100 % autónoma, siempre igual.
- →No necesita estar en el contexto en cada sesión.
- →Quieres ahorrar tokens y ventana de contexto.
Por qué aprender
Porque una skill no es la respuesta para todo, y tratar todo como skill encarece el OS. Un proceso 100 % predecible funciona de forma más económica y confiable como script: no consume contexto, no hace falta cargarlo en cada nueva sesión de Claude Code y no corre el riesgo de que la IA "improvise".
Conceptos clave
⚠️ El error común: 10 skills a la vez / skill nunca utilizada
La capa de habilidades tiene tres trampas clásicas: gente subutiliza skills, gente se acumula demasiadas skills, y la gente se cree lista y crea muchas skills a la vez — que quedan obsoleto (muertas) sin que nunca se usen. A eso se suma lo peor: escribir una skill sobre algo que tú nunca lo hizo a mano.
⚠️ El error que debes evitar
Sentarse un fin de semana y generar 10 skills «porque parecen útiles». Sin uso real, envejecen, se contradicen y saturan la carpeta skills/. Empiezas a confiar en recetas que nunca se pusieron a prueba en el fuego.
✓ Hábito saludable
- ✓Empieza con UNA skill: la tarea que más repites.
- ✓Toda skill nace de algo que ya se hizo a mano.
- ✓Crea la siguiente solo cuando el problema vuelva a aparecer.
✗ Antipatrones
- ✗10 skills a la vez «porque parecen útiles».
- ✗Skill de algo que nunca ejecutaste.
- ✗Acumular recetas que nunca se ejecutan (stale).
Por qué aprender
Porque la tentación de «convertir todo en skill» es fuerte y costosa. Una carpeta concisa de skills activas —cada una nacida de un problema real y mantenida con el uso— vale más que una biblioteca de recetas muertas. Menos es mejor, y siempre se parte de lo que ya haces.
Conceptos clave
📝 Copy-run: destila esta conversación en un slash command
Hora de ponerse manos a la obra. Haz una tarea a mano con Claude Code (cualquiera: clasificar unos archivos, redactar una respuesta estándar). Al terminar, pega el prompt de abajo: aplica el reverse meta-prompting y materializa tu primera skill: un slash command que acepta un argumento.
Copia y ejecuta en Claude Code
Objetivo: destilar la conversación que acabas de tener en un slash command reutilizable que acepta un argumento en lenguaje natural.
Pega al final de la sesión (cambia lo que está entre < >):
Com base em TODA esta conversa, destile o critério exato que eu te dei e materialize-o como um slash command reutilizável. Crie a skill em: skills/<nome-da-skill>/SKILL.md O comando deve: - chamar-se /<nome-da-skill> e ACEITAR UM ARGUMENTO (uma frase em linguagem natural que enriquece o que ele faz); - ter um procedimento operacional padrão (SOP): exatamente o que acontece, em que sequência; - listar, no fim, um "done-check": como eu verifico que deu certo. Antes de escrever o arquivo, me mostre o SOP em bullets e espere meu OK.
Cómo verificar: ejecuta /<nombre-da-skill> "un caso de prueba" en una nueva sesión. Si el comando reproduce lo que hiciste a mano y respeta el argumento que pasaste, la skill está activa. Comprueba también que el archivo skills/<nome-da-skill>/SKILL.md existe y tiene el SOP + done-check.
💡 Consejo
Observa el "espera mi OK" al final del prompt. Pedir el SOP en viñetas antes de guardar el archivo te permite corregir la receta mientras la conversación aún está fresca: es reverse meta-prompting con una puerta de revisión incorporada.
Por qué aprender
Porque es la diferencia entre leer sobre skills y tener una. Al ejecutar este prompt experimentas el ciclo completo — manual → captura → V1 — y sales del módulo con un artefacto real en la carpeta skills/ de tu OS.
Conceptos clave
📄 Anatomía de un SKILL.md
Para cerrar, veamos la receta por dentro. Un SKILL.md es solo un archivo de texto (Markdown) con cuatro partes importantes: nombre, cuándo usar (el disparador), el paso a paso (SOP) y cómo verificar. Conocer esta anatomía te permite leer, depurar y mejorar cualquier skill.
Cómo leer: de arriba hacia abajo es el orden de lectura de la propia IA: ve el nombre, decide si coincide el activador, sigue el SOP y verifica el done-check. Las tres del medio están en cian; el done-check (en morado) es lo que más olvidas y lo que más importa.
Esqueleto ilustrativo — un SKILL.md mínimo
--- name: monthly-review description: Revisa o extrato do mês e gera um resumo categorizado. --- ## Quando usar Quando eu pedir a revisão mensal de gastos, ou passar um extrato novo. ## Passo a passo (SOP) 1. Ler o extrato em <arquivo> (argumento). 2. Categorizar cada transação. 3. Apontar gastos fora do padrão. 4. Gerar o resumo em resumo-<mes>.md. ## Done-check - Todas as transações têm categoria. - O resumo lista os 3 maiores gastos do mês.
Por qué aprender
Porque la anatomía es el lenguaje común de toda la capa. Cuando lees una skill (tuya o de otra persona), buscar estas cuatro partes te indica enseguida si está completa; la ausencia de done-check es el fallo número uno. Con esto, terminas la Trilha 3.1 listo para la siguiente capa: Herramientas.
Conceptos clave
✅ Resumen del módulo
Siguiente módulo:
3.2 — Herramientas y conexiones: los hilos hacia afuera 🔌