¿Qué es un Claude skill?
Un Claude skill es un paquete reutilizable que extiende a Claude con conocimiento y workflows especializados. Piensa en él como un mini experto que Claude invoca bajo demanda: un skill para generar PDFs, otro para code reviews, otro para guiones de YouTube.
Los skills viven en ~/.claude/skills/ (nivel usuario) o en .claude/skills/ (nivel proyecto). Cada skill es una carpeta con un manifiesto SKILL.md y opcionalmente scripts auxiliares o ficheros de contexto.
Paso 1: crea la carpeta
Dentro de ~/.claude/skills/ crea una carpeta nueva con el nombre de tu skill (minúsculas, kebab-case):
mkdir -p ~/.claude/skills/mi-primer-skill
cd ~/.claude/skills/mi-primer-skill
Paso 2: escribe SKILL.md
SKILL.md es el manifiesto. Le dice a Claude cuándo y cómo usar el skill. Frontmatter requerido: name, description. Opcional: when_to_use, tags.
---
name: mi-primer-skill
description: Descripción breve de una frase que Claude lee para decidir si este skill aplica.
when_to_use: Usuario menciona la tarea X, o pide Y.
tags: [productividad, escritura]
---
# Mi primer skill
Las instrucciones detalladas para Claude van aquí. Usa headings markdown para organizar secciones.Mantén la description ajustada: Claude la usa para decidir si invoca el skill, así que la claridad importa.
Paso 3: pruébalo
Abre Claude Code en cualquier proyecto: claude
Escribe /skills, deberías ver tu skill listado. Si no, comprueba que el frontmatter sea YAML válido.
Invócalo haciendo match con la description: si tu skill genera PDFs, pide 'genera un PDF con estos datos'. Claude leerá SKILL.md y seguirá las instrucciones.
Paso 4: publícalo
Pon la carpeta del skill en un repo público de GitHub. Añade un README.md con instrucciones de instalación: 'Clónalo en ~/.claude/skills/ o copia la carpeta en .claude/skills/ dentro de tu proyecto.'
Etiqueta el repo con claude-skill para que ClaudeWave lo descubra automáticamente. Envíalo en claudewave.com/submit para revisión prioritaria y posicionamiento destacado.
Buenas prácticas
Un skill, un propósito. No construyas un mega-skill que haga 10 cosas. Claude despacha mejor cuando cada skill es estrecho y está bien nombrado.
Escribe la description desde la perspectiva del usuario: lo que pediría, no lo que hace tu código.
Incluye ejemplos concretos en el cuerpo de SKILL.md. Claude rinde mejor con 2 o 3 ejemplos que con instrucciones abstractas.
Usa .claude/skills/ a nivel proyecto para skills compartidos por el equipo (commiteados a git). Usa ~/.claude/skills/ para herramientas personales.