Skills de Claude Code: cómo crearlas, con ejemplos y buenas prácticas

Qué son las skills de Claude Code

Crea una skill cuando te encuentres pegando una y otra vez en el chat las mismas instrucciones, la misma checklist o el mismo procedimiento de varios pasos, o cuando una parte de tu CLAUDE.md haya pasado de ser un dato a ser un procedimiento. Las skills siguen el estándar abierto Agent Skills (agentskills.io), que también leen otras herramientas de IA; Claude Code añade extras como el control de invocación, la ejecución en subagentes y la salida de shell en vivo dentro del prompt.

• Dos formas de ejecutarla: Claude la carga cuando tu petición coincide con su description, o escribes /skill-name.
• Barata hasta que se usa: en el contexto solo están el nombre y la descripción; el cuerpo se carga cuando la skill se ejecuta. Una skill configurada para lanzarse solo a mano ni siquiera muestra su descripción.
• Los comandos de barra propios ahora son skills: .claude/commands/<name>.md sigue funcionando, pero una carpeta de skill también puede contener archivos de apoyo. Consulta comandos de barra de Claude Code.
• Claude Code también trae skills incluidas, como /simplify, /loop, /batch y /debug.

Skills frente a CLAUDE.md, subagentes, plugins y MCP

Cómo crear una skill de Claude Code

1. Elige dónde vive

   ~/.claude/skills/<name>/ para ti en todos tus proyectos; .claude/skills/<name>/ en un repositorio, con commit, para todos los que trabajan en él. El nombre de la carpeta se convierte en el comando: summarize-changes da /summarize-changes.

2. Escribe el SKILL.md: una descripción y luego las instrucciones

   El frontmatter va entre líneas --- al principio del todo. Solo se recomienda description: pon primero el caso de uso y las palabras que la gente diría de verdad. Debajo, escribe las instrucciones en Markdown. Una línea que empieza con ` !command ` ejecuta antes ese comando y pega su salida, así que la skill trabaja con tu estado real.

   ---
   description: Resume los cambios sin commit y señala lo que sea arriesgado. Úsala cuando el usuario pregunte qué cambió, quiera un mensaje de commit o pida revisar su diff.
   ---
   
   ## Cambios actuales
   
   !`git diff HEAD`
   
   ## Instrucciones
   
   Resume los cambios de arriba en dos o tres viñetas y después enumera los
   riesgos, como manejo de errores ausente, valores fijos en el código o tests que actualizar.

3. Pruébala de las dos formas

   Abre claude en un proyecto git con un cambio sin commit. Pregunta "¿Qué he cambiado?" para ver si Claude elige la skill por su cuenta, y después escribe /summarize-changes para ejecutarla directamente. Las skills que añades durante una sesión se cargan solas; ejecuta /reload-skills si alguna no aparece.

4. Decide quién puede ejecutarla

   Añade disable-model-invocation: true a todo lo que tenga efectos secundarios, como despliegues o envío de mensajes, para que solo tú puedas lanzarla. Añade user-invocable: false al conocimiento de fondo que solo debe cargar Claude. Pasa datos con $ARGUMENTS, como se muestra en la guía de comandos de barra.

5. Compártela

   Haz commit de .claude/skills/ en el repositorio, o empaqueta las skills como un plugin para varios repositorios o equipos.

Fuente: documentación de Claude Code, Extend Claude with skills

Ejemplos de skills de Claude Code

1. Una skill de referencia que solo se carga con los archivos que coinciden

   Las skills de referencia contienen convenciones que Claude aplica mientras trabaja. paths limita la carga automática a los archivos que coinciden con los globs.

   ---
   description: Convenciones de diseño de API de este código. Úsala al escribir o revisar endpoints HTTP.
   paths: ["src/api/**"]
   ---
   
   Al escribir endpoints de API:
   - Usa nombres RESTful y recursos en plural
   - Devuelve los errores como { error: { code, message } }
   - Valida el cuerpo de la petición con los esquemas de src/api/schemas/

2. Una skill de tarea con archivos de apoyo

   Mantén el SKILL.md corto y remite al resto. Claude lee checklist.md solo cuando el SKILL.md se lo indica, y ejecuta bump.sh sin leerlo, así que los detalles no cuestan nada hasta que hacen falta.

   release/
   ├── SKILL.md          # los pasos, y cuándo leer los demás archivos
   ├── checklist.md      # se carga solo cuando SKILL.md remite a él
   └── scripts/
       └── bump.sh       # se ejecuta, no se lee en el contexto

3. Una skill que se ejecuta en su propio subagente

   context: fork inicia un subagente (aquí el tipo Explore, de solo lectura) con la skill como prompt. No ve tu conversación, así que las instrucciones deben entenderse por sí solas; se ejecuta en segundo plano salvo que pongas background: false.

   ---
   description: Audita las dependencias en busca de vulnerabilidades conocidas y versiones mayores desactualizadas
   context: fork
   agent: Explore
   disable-model-invocation: true
   ---
   
   Ejecuta la auditoría del gestor de paquetes, enumera cada hallazgo alto o crítico
   con la versión que lo corrige e indica qué versiones mayores van por detrás. No cambies ningún archivo.

Instalar skills desde plugins y marketplaces

Las skills que escriben otras personas suelen llegar dentro de plugins. Claude Code registra el marketplace oficial de Anthropic (claude-plugins-official) la primera vez que inicias una sesión interactiva; explóralo con /plugin o instala directamente, por ejemplo /plugin install skill-creator@claude-plugins-official. Para un marketplace de un equipo o de la comunidad, añádelo antes con /plugin marketplace add owner/repo.

• Las skills de un plugin se llaman /plugin-name:skill-name.
• El marketplace oficial muestra el coste de contexto de cada plugin por turno y al invocarlo.
• El plugin skill-creator ayuda a escribir una skill y ejecuta evals que comparan los resultados con ella y sin ella.
• Lee las skills de un repositorio o de un plugin antes de fiarte de ellas: allowed-tools puede aprobar de antemano herramientas durante el turno en que se ejecuta una skill.

Buenas prácticas, y qué hacer cuando Claude ignora una skill

• Escribe la descripción pensando en la coincidencia: empieza por la tarea y por las frases que dicen los usuarios. La descripción más when_to_use se corta a los 1.536 caracteres en el listado.
• Pon las instrucciones más importantes cerca del principio: después de compactar la conversación, Claude Code puede conservar solo el inicio de una skill invocada. Invócala de nuevo para restaurarla.
• Redacta las indicaciones para toda la tarea ("ejecuta los tests después de cada edición"), porque el archivo de la skill no se vuelve a leer en los turnos siguientes. Una regla que nunca debe saltarse va en un hook.
• Para reducir el uso de tokens, saca los procedimientos de CLAUDE.md y pásalos a skills, pon disable-model-invocation: true en las skills que lanzas a mano y revisa /skill-doctor para encontrar skills que cuestan contexto pero casi no se usan.
• ¿No se activa? Comprueba que la descripción tiene las palabras clave adecuadas, pregunta "¿Qué skills hay disponibles?" y ejecuta claude plugin validate .claude/skills para encontrar frontmatter que no se puede analizar.
• ¿Se activa demasiado? Haz la descripción más específica o pasa la skill a manual con disable-model-invocation: true.

Las skills enseñan a Claude Code cómo hacerlo. Crewmark le da algo que hacer cada hora.

Una biblioteca de skills hace que cada sesión sea capaz, pero sigue esperando a que se lo pidas. Crewmark convierte una sesión de Claude Code, Codex, DeepSeek Harness u OpenCode en un empleado de IA con un rol, un objetivo y un horario, y la despierta con un heartbeat para que tome la siguiente issue de un tablero, con las skills de tu proyecto cargadas.

1. Guarda las skills en el repositorio

   La sesión del empleado lee .claude/skills/ y CLAUDE.md igual que la tuya, así que una skill de release o una checklist de revisión van con él.

2. Deja que el heartbeat inicie el trabajo

   Durante su horario laboral el empleado se despierta cada 15, 30 o 60 minutos en la misma conversación y toma la siguiente issue; mira cómo hacer proactivo a Claude Code.

3. Asigna issues y responde a sus mensajes

   Pon el trabajo en el tablero; el empleado comenta a medida que avanza y te escribe cuando necesita una decisión. Lee qué es un empleado de IA.

Preguntas frecuentes sobre las skills de Claude Code