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.PATCH
tags: 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.