🚀 Tutorial 1: Crea tu librería de Skills reutilizables y encadenables

⏱ Tiempo estimado: 23 minutos 🎯 Rama / Perfil: Marketers y creadores de contenido 🧠 Conocimiento previo necesario: Haber instalado Claude Code y entender la idea básica de un "skill" (clase 5 del curso, donde se crea un skill de entrevistas). Aquí asumimos que ya tienes Claude Code funcionando en tu computador. 💡 ¿Qué vas a lograr? Una carpeta con 3 skills que se activan solos y se encadenan entre sí para convertir un solo texto en 3 formatos de contenido distintos (blog → hilo para X → guion de video corto).

🛠 Lo que necesitas antes de empezar

• Claude Code instalado → Guía oficial de instalación
• Un editor de texto simple (puede ser el Bloc de notas o VS Code)
• Un texto de ejemplo tuyo (un post, artículo o newsletter) en un archivo .txt o .md

📋 Pasos

Paso 1 — Entiende la estructura real de un skill

Un skill no es solo un archivo suelto: es una carpeta con un archivo SKILL.md adentro que tiene una cabecera especial (llamada "frontmatter") con un name y una description. Esa description es lo que Claude lee para decidir si debe activar el skill solo, sin que tú lo invoques a mano. 🔗 Documentación oficial de Skills en Claude Code

Paso 2 — Crea la carpeta de skills en tu proyecto

Dentro de la carpeta de tu proyecto, crea .claude/skills/. Ahí vivirán todos tus skills. Si quieres que estén disponibles en todos tus proyectos (no solo en uno), créalos en ~/.claude/skills/ en tu carpeta de usuario.

Paso 3 — Crea el primer skill: "repurpose-a-hilo"

Dentro de .claude/skills/repurpose-a-hilo/, crea un archivo SKILL.md con este contenido:

markdown

---
name: repurpose-a-hilo
description: Usar cuando el usuario pida convertir un texto largo (blog, artículo, newsletter) en un hilo para X/Twitter. Divide en 5-8 tweets, mantiene la idea central del primer párrafo como gancho.
---

Convierte el texto que te den en un hilo de 5 a 8 tweets.
Reglas:
- El primer tweet debe ser un gancho fuerte, sin spoilear la conclusión.
- Cada tweet debe poder leerse solo (evita "como dije antes").
- Usa un tono directo, sin relleno.
- Termina el hilo con una pregunta o llamado a la acción.

Paso 4 — Crea el segundo skill: "repurpose-a-guion"

Repite el proceso en .claude/skills/repurpose-a-guion/SKILL.md, pero con instrucciones para convertir el texto en un guion de video corto (30-60 segundos): gancho en los primeros 3 segundos, desarrollo, cierre con CTA.

Paso 5 — Crea el tercer skill: "orquestador-contenido"

Este es el skill que encadena a los otros dos. En .claude/skills/orquestador-contenido/SKILL.md, escribe instrucciones que le digan a Claude: "cuando te pidan repurposear contenido completo, usa primero el skill repurpose-a-hilo, luego repurpose-a-guion, y entrega ambos resultados organizados".

Paso 6 — Pon a prueba la cadena completa

Abre Claude Code en la carpeta de tu proyecto y escribe:

Toma el archivo mi-post.md y repropósalo completo

Claude debería detectar solo que necesita el skill orquestador, y este a su vez activar los otros dos. Verás en la terminal cómo Claude "carga" cada SKILL.md en el momento en que lo necesita (esto se llama progressive disclosure: no ocupa espacio de contexto hasta que hace falta).

Paso 7 — Ajusta las descripciones si no se activan solos

Si Claude no activa un skill cuando esperabas, el problema casi siempre está en la description: hazla más específica, con ejemplos de frases que el usuario podría escribir.

✅ Resultado esperado

Una carpeta .claude/skills/ con 3 skills funcionales: dos especializados (hilo y guion) y uno orquestador que los encadena. Cualquier texto que sueltes en esa carpeta puede convertirse automáticamente en 2 formatos nuevos con un solo comando.

🔥 Tu reto (siguiente acción)

Agrega un cuarto skill llamado "revisor-de-tono" que revise los 3 resultados y los ajuste para que sigan la voz de tu marca (defínela en 3-4 adjetivos dentro del propio SKILL.md). Haz que el orquestador lo llame al final de la cadena.

📚 Recursos para ir más lejos

• Documentación de Skills — Claude Code — Referencia completa de frontmatter, ubicaciones y comportamiento de carga.
• Agent Skills overview — Claude Platform — Explica el estándar abierto detrás de los skills, útil si luego quieres usarlos en otras herramientas.