Referencia de frontmatter
Todos los ficheros SKILL.md deben incluir frontmatter YAML entre delimitadores --- al inicio del fichero.
Campos requeridos
| Campo | Tipo | Descripción |
|---|---|---|
name |
string | Identificador único en kebab-case. Debe coincidir con el nombre del directorio. |
title |
string | Nombre legible que se muestra en el marketplace. |
description |
string | Una frase que describe qué hace el skill. |
version |
string | Cadena de versión semántica (p. ej., "1.2.0"). |
author |
string | Tu handle de GitHub. |
trigger |
string | Cuándo debe activar el agente este skill. Sé específico. |
Frontmatter mínimo válido
---
name: my-skill
title: "My Skill"
description: "Does one specific thing clearly."
version: "1.0.0"
author: "your-github-handle"
trigger: "Use when the user asks to do X."
---Campos opcionales
| Campo | Tipo | Valor por defecto | Descripción |
|---|---|---|---|
tags |
string[] | [] |
Etiquetas de categoría para filtrar búsquedas. Máximo 5. |
license |
string | "MIT" |
Identificador de licencia SPDX. |
homepage |
string | — | URL de la documentación o repositorio de tu skill. |
repository |
string | — | URL del repositorio de GitHub (autodetectada si se envía vía GitHub). |
min_runtime |
string | — | Versión mínima requerida de Claude Code (p. ej., "1.4.0"). |
tools |
string[] | [] |
Lista de herramientas que el skill invoca (p. ej., ["Bash", "Read", "Write"]). |
deprecated |
boolean | false |
Marca el skill como obsoleto. Lo suprime de las búsquedas. |
deprecated_by |
string | — | Nombre del skill que reemplaza a este. |
experimental |
boolean | false |
Marca como experimental. Muestra un badge de aviso. |
Ejemplo completo con campos opcionales
---
name: rna-qc
title: "Single-Cell RNA QC"
description: "Performs quality control on scRNA-seq data using Seurat and scran."
version: "2.1.0"
author: "bioinformatics-jeff"
trigger: "Use when the user wants to perform QC on single-cell RNA-seq data, filter low-quality cells, or assess mitochondrial content."
tags:
- bioinformatics
- single-cell
- R
- quality-control
license: MIT
homepage: "https://github.com/bioinformatics-jeff/rna-qc"
repository: "https://github.com/bioinformatics-jeff/rna-qc"
min_runtime: "1.3.0"
tools:
- Bash
- Read
- Write
experimental: false
---Reglas de validación de campos
name: solo minúsculas, números y guiones. Sin espacios. Debe coincidir exactamente con el nombre del directorio.version: debe seguir semver —MAJOR.MINOR.PATCHtags: cada tag en minúsculas, sin espacios (usa guiones). Máximo 5 tags por skill.trigger: mínimo 10 palabras. Los triggers vagos (< 10 palabras) no pasan la validación.description: máximo 160 caracteres (cabe en las tarjetas de resultados de búsqueda).
Validación de esquema
Ejecuta npx @hordago/skill-validator para comprobar tu frontmatter contra el esquema completo antes de enviarlo. Los errores de validación se informan con números de línea y sugerencias de corrección.