🛠️ Tutorial paso a paso

Crea tus propias Skills de Claude

De cero a tu primera skill funcionando en menos de 10 minutos. Sin experiencia previa: si sabes escribir instrucciones claras, sabes crear skills.

La anatomía de una skill

Una skill es simplemente una carpeta con un archivo SKILL.md dentro. Ese archivo tiene dos partes: un frontmatter (metadatos entre ---) y el cuerpo con las instrucciones. Opcionalmente puedes añadir scripts, plantillas y archivos de referencia.

estructurami-skill/ ├── SKILL.md ← obligatorio: metadatos + instrucciones ├── referencias/ ← opcional: docs que Claude consulta │ └── ejemplos.md └── scripts/ ← opcional: código que Claude ejecuta └── procesar.py

Crea la carpeta de la skill

En Claude Code viven en ~/.claude/skills/ (personales) o .claude/skills/ dentro de tu proyecto (compartidas con tu equipo). Crea una carpeta con un nombre corto en minúsculas: informes-semanales, estilo-marca

Escribe el frontmatter

Solo dos campos son imprescindibles: name y description. La descripción es CRÍTICA: es lo único que Claude ve antes de decidir si usar la skill. Incluye qué hace y cuándo usarla, con las palabras que usarías tú al pedirlo.

Añade las instrucciones

Escribe el cuerpo como si entrenaras a un empleado nuevo brillante pero sin contexto: pasos concretos, ejemplos de entrada y salida, qué hacer en casos límite y qué NO hacer jamás.

Pruébala

Abre Claude Code y pide una tarea que debería activarla. ¿No se activa? Mejora la descripción. ¿Resultado flojo? Añade ejemplos al cuerpo. También puedes invocarla directamente con /mi-skill.

Itera y compártela

Las mejores skills se afinan con uso real. Cuando estés contento, súbela a GitHub, empaquétala en un plugin o compártela con tu equipo vía el repositorio del proyecto.

Ejemplo completo: skill de informes semanales

SKILL.md--- name: informes-semanales description: Genera el informe semanal del equipo siguiendo la plantilla corporativa. Usar cuando pidan "informe semanal", "resumen de la semana" o "weekly report". --- # Informe semanal ## Proceso 1. Pide (o localiza) los hitos de la semana. 2. Estructura SIEMPRE en: Logros, En curso, Bloqueos, Próxima semana. 3. Máximo 1 página. Frases cortas. Datos concretos, no vaguedades. 4. Tono: directo y profesional, sin jerga corporativa vacía. ## Formato de salida - Documento Word (.docx) con la plantilla de la empresa. - Titular: "Informe semanal — [equipo] — [fecha]". ## Nunca - Inventar métricas que no te hayan dado. - Superar una página.

Buenas prácticas de los profesionales

  • Una skill = una capacidad. Mejor cinco skills pequeñas y precisas que una gigante que hace de todo.
  • Descripción con triggers. Incluye en la descripción las palabras exactas con las que la gente pedirá esa tarea (en español e inglés si trabajas en ambos).
  • Menos de 500 líneas. Si el SKILL.md crece demasiado, mueve el detalle a archivos de referencias/ que Claude lee solo cuando los necesita.
  • Scripts para lo determinista. Si un paso es siempre igual (convertir un archivo, validar un formato), dáselo como script ejecutable en vez de explicárselo.
  • Ejemplos reales. Un par de ejemplos de entrada → salida perfecta valen más que párrafos de teoría.

El atajo: pídele la skill a Claude

El truco favorito de la comunidad: Claude tiene una skill oficial (skill-creator) para crear skills. Basta con pedirle «créame una skill que haga X» y él mismo genera la estructura, el frontmatter y las instrucciones — tú solo revisas y afinas. Meta, ¿verdad?

Inspírate en las skills de la comunidad

Cientos de skills open source listas para estudiar, copiar y mejorar.