Documentación
El formato, las puertas y las superficies.
El formato de skill
Una skill es un directorio que contiene SKILL.md — un archivo Markdown con frontmatter YAML que lleva un `name` y una `description`. La descripción es lo que lee un agente para decidir si carga la skill, así que debe indicar tanto qué hace como cuándo usarla. Los archivos de apoyo viven al lado y se referencian desde el cuerpo, de modo que el agente solo los lee cuando los necesita.
Puertas de calidad
La puerta 0 valida el frontmatter y el esquema. La puerta 1 analiza la estructura — divulgación progresiva, límites de tamaño, sin rutas absolutas, sin secretos filtrados. Ambas corren dentro de la petición, en menos de una quinta parte de segundo. La puerta 2 ejecuta una evaluación de activación de forma asíncrona: un modelo juez comprueba si la skill se dispara con los prompts que debería y calla con los que no. La puerta 3 ejecuta los scripts incluidos en un sandbox.
Instalar una skill
Cada página de skill muestra un comando de instalación de una línea. Escribe el directorio de la skill en tu proyecto para que tu agente lo recoja en la siguiente ejecución. No se instala nada globalmente y no se ejecuta nada durante la instalación.
Superficies legibles por agentes
El registro se publica en los formatos que buscan los agentes: /llms.txt como índice Markdown, /index.json como índice tipado y una versión Markdown limpia de cada skill. Una cabecera Content-Signal declara cómo puede usarse el contenido. Es la misma maquinaria de la que tratan las propias skills.
Example SKILL.md
---
name: core-web-vitals-audit
description: Audits a web application for Core Web Vitals
regressions. Use when the user asks to check LCP, INP or
CLS, or investigate a Lighthouse score drop.
---
# Core Web Vitals audit
## When to use this
...
## Procedure
1. Measure first, guess never.
2. See [references/thresholds.md](references/thresholds.md).