📁 Carpeta + SKILL.md
La estructura mínima de una skill es absoluta: una carpeta con cualquier nombre y, dentro, un único archivo llamado SKILL.md. Eso es todo. Nada más es obligatorio.
Una skill es una carpeta. Dentro está el SKILL.md — el único archivo que Claude Code necesita para cargar y ejecutar el comportamiento definido. Opcionalmente, la carpeta puede tener una subcarpeta references/ con archivos de apoyo.
Cuando Claude Code encuentra SKILL.md en la carpeta de skills configurada (~/.claude/skills/), pone esa skill a disposición como un comando /nome-da-skill.
references/house-style.md
scripts/composition-template.mjs
El nombre de la carpeta se convierte en el nombre del comando. video-explicativo/ se convierte en /video-explicativo. Elige nombres descriptivos sin espacios: usa guiones.
📦 Conocimiento empaquetado
Una skill no es un prompt efímero que escribes en el momento: es un procedimiento reutilizable, probado y versionable. Es conocimiento que enseñas una vez y que Claude aplica cada vez que lo necesita.
Piensa en una receta de cocina. No reinventas la receta cada vez que vas a cocinar: la escribiste una vez, la guardaste y la sigues. Una skill es exactamente eso: la receta escrita, guardada y reutilizable para cualquier "preparación" futura.
El SKILL.md de la video-explicativo define el flujo completo de creación de videos: guion → narración TTS → escenas animadas → render → captions → CTA. Este conocimiento queda empaquetado y listo para reutilizarse.
Describe en SKILL.md el procedimiento, las reglas de oro y los estándares de calidad. Puede tomar 30 minutos, o incluso horas si es complejo.
Cada vez que invoques /video-explicativo, Claude carga el SKILL.md y sigue las instrucciones, sin que tengas que repetir nada.
El video de INEMA.CLUB siempre tiene una paleta #0D1321, voz pf_dora --speed 0.98, fundido de 0.45s — porque está escrito en la skill.
Cuando descubres algo mejor (por ejemplo, un nuevo timing de LEAD o TAIL), editas SKILL.md una vez y todos los videos futuros heredan la mejora.
Si el procedimiento solo está en tu memoria, cada nueva sesión empieza desde cero. Tienes que volver a explicarle el mismo flujo a Claude, cometes los mismos errores y pierdes consistencia. La skill elimina ese costo.
✍️ Markdown como instrucción
El cuerpo del SKILL.md es puro Markdown. Claude interpreta este texto como instrucciones de ejecución: no como documentación para personas, sino como órdenes que seguirá.
El SKILL.md tiene dos partes: el front-matter (encabezado con name: e description:) e o cuerpo — secciones Markdown con el procedimiento completo. Claude Code usa el front matter para listar y activar la skill; el cuerpo, para ejecutarla.
- ✓ Escribe en imperativo: "Lee…", "Crea…", "Genera…"
- ✓ Usa secciones con
##para separar el flujo y las reglas - ✓ Incluye valores exactos:
--speed 0.98, no «velocidad lenta» - ✓ Marca lo que no es negociable con "NUNCA" o "SIEMPRE"
- ✗ No seas vago: «haz un buen video» no funciona
- ✗ No omitas el front-matter (name: y description:)
- ✗ No escribas como si fuera documentación técnica impersonal
- ✗ No pongas instrucciones de ejecución en los archivos de referencia
Cuando escribes /video-explicativo, Claude Code inyecta el contenido completo del SKILL.md en el contexto de la sesión antes de responder. Por eso, las instrucciones del principio y del final tienen el mismo peso.
⚖️ Skill vs. prompt independiente
Un prompt aislado funciona una vez, en esa sesión y con ese contexto. Una skill es duradera, automática y reproducible: la diferencia entre una nota adhesiva y un manual de operaciones.
| Aspecto | Skill | Prompt aislado |
|---|---|---|
| Durabilidad | Permanente (archivo) | Efímero (desaparece con la sesión) |
| Activación | Automática mediante /nome | Manual, tú escribes todo |
| Consistencia | Idéntico cada vez | Varía según la memoria |
| Mantenimiento | Edita el archivo | Reescribe todo el prompt |
| Compartir | Git, zip, copia de carpeta | Ctrl+C / Ctrl+V manual |
- ✓ Vas a repetir el mismo tipo de tarea muchas veces
- ✓ Necesitas consistencia absoluta (branding, formato)
- ✓ Quieres compartir el procedimiento con otras personas
- ✓ El flujo tiene más de 3 pasos o reglas críticas
- ✗ Es una pregunta única, no se repetirá
- ✗ El contexto cambia por completo cada vez
- ✗ Exploración rápida, sin necesidad de reproducir
- ✗ Tarea de 1 paso sin parámetros específicos
Una heurística sencilla: si te imaginas haciendo la misma tarea 3 o más veces, el tiempo que inviertes en escribir el SKILL.md se recupera ya en la cuarta ejecución. Si son menos de 3, un prompt aislado es más rápido.
🎯 Ejemplos: video, código, UI
Las skills cubren cualquier dominio — no solo video. Este curso completo nació de una skill (formato-curso). Mira la variedad posible.
Cada página de este curso fue creada por la skill formato-curso. Define los componentes, el CSS dark premium, la estructura de módulos y los estándares de calidad de INEMA.CLUB: todo en Markdown, sin una línea de código JavaScript.
La skill video-explicativo (que enseña este curso) define el flujo HTML→MP4: paleta #0D1321, voz pf_dora, timings LEAD=0.5 TAIL=0.9 FADE=0.45. Dos dominios, la misma estructura: carpeta + SKILL.md.
Guion → TTS pf_dora → escenas HTML oscuras → render MP4. Flujo de 8 pasos fijos, paleta #0D1321, formatos 16:9 y 9:16.
Genera HTML con Tailwind, SVG futuristas, temas expandibles y modales. Define todos los componentes y paletas por ruta.
Distribuye las búsquedas, verifica fuentes y sintetiza un informe con citas. Skill de investigación con verificación adversarial.
Genera y valida flujos de automatización n8n con patrones de código JavaScript y expresiones de nodo específicos.
Crea componentes y páginas web con patrones visuales específicos, tokens de diseño y guías de estilo.
Audita el código en busca de vulnerabilidades con listas de verificación de OWASP y estándares de seguridad específicos.
→ lista todas las skills activas
→ cada una = una carpeta
→ cada carpeta = un SKILL.md
🚀 Sin escribir código
Una skill sencilla es solo texto. No necesitas saber JavaScript, Python ni ningún lenguaje de programación para crear skills potentes: Markdown es suficiente.
Cuando escribes "1. Lee el tema. 2. Crea un guion de 3 escenas. 3. Usa la voz pf_dora." en SKILL.md, eso é un programa. Claude interpreta instrucciones en lenguaje natural con la misma fidelidad con que una computadora interpreta código.
La skill video-explicativo tiene cientos de instrucciones precisas —timings, paletas, formatos— y está íntegramente en Markdown. Cero JavaScript en el SKILL.md principal.
La carpeta references/ puede contener scripts como narration-template.sh e composition-template.mjs — pero estos son templates que Claude usa como modelo, no código que la skill ejecuta directamente. La skill da instrucciones; las plantillas sirven de ejemplo.
- ✓ Crea la carpeta y el archivo SKILL.md en 10 minutos
- ✓ Escribe instrucciones claras en portugués
- ✓ Prueba llamando
/nome-da-skillen Claude Code - ✓ Itera: edita el SKILL.md a medida que aprendes
- ✗ No esperes a saber programar para empezar
- ✗ No intentes cubrir todos los casos de uso de una vez
- ✗ No uses YAML complejo cuando Markdown es suficiente
- ✗ No esperes a que la skill esté «perfecta» para usarla
La skill más sencilla posible: name: minha-skill, description: o que faz, y 3-5 pasos en Markdown. Ejecuta, ajusta, amplía. La skill video-explicativo que vas a aprender en este curso comenzó así, y hoy tiene referencias, scripts y cientos de reglas.
Instrucciones de tono, formato y firma predeterminada. 8 líneas. Ahorra 5 minutos por email.
Plantilla de secciones, métricas obligatorias, tono ejecutivo. 12 líneas. Consistencia total.
Checklist de hipótesis, formato de diagnóstico, estándar de commit de fix. 10 líneas.
📋 Resumen del Módulo 1.1
- ✓ Skill = carpeta +
SKILL.md— estructura mínima y suficiente - ✓ Conocimiento empaquetado: escribe una vez, reutiliza siempre
- ✓ El cuerpo del SKILL.md es Markdown que Claude ejecuta como instrucciones
- ✓ La skill es duradera + automática; el prompt suelto es efímero + manual
- ✓ Dominios: video, código, UI, investigación; este curso nació de un skill
- ✓ Empieza con 10 líneas de Markdown: no necesitas código
references/.