Inicio / Extender: habilidades, MCP, subagentes, hooks, plugins

Skills: enseñar un workflow a Claude

Una skill encapsula un workflow reproducible en un archivo SKILL.md, invocada por un comando slash explícito o por correspondencia automática con su descripción.

Una skill agrupa un modo operativo completo en un solo archivo, SKILL.md, que Claude Code carga como un manual que sabe seguir sin necesidad de repetirlo en cada solicitud. El archivo vive en una carpeta que lleva el nombre de la skill, y su contenido comienza con un bloque de encabezado en frontmatter, cuyo único campo realmente recomendado es una descripción en lenguaje natural: lo que hace la skill, y en qué situación debe aplicarse. Si el campo se omite, Claude Code recurre al primer párrafo del contenido Markdown para decidir el desencadenamiento.

Dos formas de activarla

Claude invoca una skill de dos maneras distintas. La primera es explícita: escribir un comando slash con el nombre de la carpeta, por ejemplo /verificar-diacriticos para una skill guardada en verificar-diacriticos/SKILL.md. La segunda es automática: en el momento de procesar una solicitud, Claude compara su texto con la descripción de cada skill instalada, y carga aquella cuya descripción coincide mejor con el tema en curso. Ninguna skill se activa sin que su descripción mencione, en esencia, la situación que debe hacerla entrar en juego, y una descripción demasiado vaga o demasiado general no coincide con nada preciso.

# Exemple illustratif, sur un dossier de démonstration
mkdir -p demo-skill/resumer-changelog
cat > demo-skill/resumer-changelog/SKILL.md <<'EOF'
---
description: Resume les derniers commits d'un depot en un changelog court, a utiliser quand on demande de preparer une note de version.
---
Lis les commits fournis, groupe-les par type, et rends une liste a puces
courte, une ligne par changement notable.
EOF

Lo que Claude agrega realmente a su caja de herramientas

Una vez cargada la skill, su contenido se suma al turno en curso como instrucciones adicionales, al mismo título que una consigna escrita directamente. Nada se ejecuta por adelantado: es el texto del archivo el que guía la respuesta, no un programa separado que correría en segundo plano. Por eso una skill bien escrita se parece a una nota que se le dejaría a un colega que retoma una tarea precisa, con suficiente detalle para no tener que adivinar, y suficientemente poco para seguir siendo legible en una sola pasada.

El gesto que merece una skill no es cualquier gesto: es el que se repite. Una explicación dada una sola vez no justifica el rodeo de un archivo. Una explicación repetida tres veces en la misma semana, en cambio, ya cuesta más repetirla que fijarla de una vez por todas. La continuación lógica, escribir y probar tu propia skill, se encuentra en crear una skill que también se convierte en un comando.