Glosario de Claude Code
SKILL.md
SKILL.md es un archivo markdown que define el comportamiento de una skill de Claude Code, compuesto por frontmatter YAML e instrucciones markdown.
También llamado: SKILL.md file, skill file, what is a SKILL.md
Un SKILL.md es un archivo markdown que sirve como unidad fundamental para una skill de Claude Code. Consta de dos partes distintas: frontmatter YAML delimitado por marcadores ---, y contenido markdown que proporciona las instrucciones que Claude sigue cuando se ejecuta la skill.
El archivo SKILL.md reside dentro de una estructura de directorios específica. Para skills personales disponibles en todos tus proyectos, se encuentra en ~/.claude/skills/<skill-name>/SKILL.md. Para skills específicas del proyecto, la ruta es .claude/skills/<skill-name>/SKILL.md. Si la skill forma parte de un plugin, se encontrará en <plugin>/skills/<skill-name>/SKILL.md.
El nombre del directorio que contiene el archivo SKILL.md dicta el comando que usas para invocar la skill a través de un comando de barra (por ejemplo, /skill-name). Sin embargo, el campo name dentro del frontmatter YAML establece la etiqueta de visualización que aparece en las listas de skills. Una excepción ocurre con los archivos SKILL.md raíz de plugin, donde el campo name determina directamente el nombre del comando, ya que no hay un directorio de skill dedicado del cual derivarlo.
Más allá del propio archivo SKILL.md, el directorio de la skill puede albergar archivos adicionales como documentación de referencia o scripts. Claude Code carga estos archivos suplementarios solo cuando son necesarios durante la operación de la skill. Claude Code monitorea activamente estos directorios de skills. En consecuencia, los cambios realizados en un archivo SKILL.md o la adición de nuevos archivos tendrán efecto dentro de la sesión actual sin necesidad de reiniciar. Sin embargo, la creación de un directorio de skills de nivel superior que no existía al inicio de la sesión requerirá un reinicio para que Claude Code lo reconozca.
Las skills de Claude Code se adhieren al estándar abierto Agent Skills, promoviendo la interoperabilidad y un enfoque consistente para el desarrollo de skills. Para obtener orientación sobre cómo crear archivos de skill bien estructurados, consulta Authoring Skills.