Frontmatter — Glosario de Claude Code

Frontmatter es el bloque YAML delimitado por --- en la parte superior de un archivo SKILL.md. Sirve como la configuración para la skill, controlando sus metadatos y comportamiento de ejecución.

Los campos clave dentro del frontmatter permiten un control detallado:

name: El nombre de visualización de la skill. Si se omite, se utiliza el nombre del directorio de la skill.
description: Un campo crucial que explica qué hace la skill y su caso de uso previsto. Si falta, la skill recurre a usar el primer párrafo del contenido markdown. Este campo es fundamental para la invocación automática.
when_to_use: Proporciona contexto adicional para activar la skill, adjunto a la description.
argument-hint: Ofrece una pista que se muestra durante la autocompletación, como [issue-number].
arguments: Define argumentos posicionales con nombre que se pueden usar con sustitución $name.
disable-model-invocation: Establecer esto en true evita que Claude invoque automáticamente la skill.
user-invocable: Establecer en false oculta la skill del menú de comandos /. Tenga en cuenta que la ortografía correcta es user-invocable con 'c'.
allowed-tools: Especifica las herramientas que se pueden usar sin permiso explícito mientras la skill está activa.
disallowed-tools: Enumera las herramientas que se eliminan del grupo disponible cuando la skill está activa.
model: Determina qué modelo utiliza Claude mientras la skill está activa.
effort: Clasifica la complejidad de la skill con niveles como low, medium, high, xhigh o max.
context: Establecer esto en fork ejecuta la skill en un contexto de subagente bifurcado.
agent: Especifica el tipo de subagente a usar cuando context se establece en fork.
hooks: Permite definir hooks limitados al ciclo de vida de la skill.
paths: Utiliza patrones glob para limitar cuándo se activa automáticamente la skill.
shell: Define el shell a usar, ya sea bash o powershell.

Si bien muchos campos ofrecen un control granular, el campo description es particularmente importante para habilitar la invocación automática de skills. Por ejemplo, la skill Skill Creator utiliza frontmatter para definir su nombre, descripción y argumentos, guiando a los usuarios sobre cómo crear nuevas skills.