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

Skills: enseñar un workflow a Claude

Una skill enseña un workflow a Claude al reunir un modo operativo completo en un solo archivo SKILL.md. Claude la activa de dos maneras: con un comando slash que lleva el nombre de la carpeta, o automáticamente cuando su descripción coincide con la solicitud. Una vez cargada, su texto se suma al turno como instrucciones adicionales.

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 vaga 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 una skill agrega al turno en curso

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.

Solo merece una skill el gesto 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.

Un estándar abierto y las salvaguardas de Claude Code

El formato Agent Skills es un estándar abierto: el 22 de octubre de 2026, Anthropic lo cedió a la Agentic AI Foundation, integrada en la Linux Foundation. En Claude Code, conviene conocer dos comportamientos recientes. Tras una compactación de la conversación, la lista de skills se vuelve a enviar a Claude, así que ya no hace falta lanzar /reload-skills para recuperarlas. Y si existe una skill llamada verify en tu proyecto o en las tuyas, se invita a Claude a lanzarla justo antes de un commit, salvo en commits solo de documentación o de tests: una skill verify se convierte en una salvaguarda de commit sin hook.