Agent Skills de 0 a Hero

Un agente moderno sabe leer archivos, ejecutar comandos, llamar APIs y escribir código. Lo que no sabe es cómo hace las cosas tu equipo: qué formato tienen tus informes, qué pasos sigue tu proceso de revisión, qué campos son obligatorios en tu esquema, qué gotcha te hizo perder una tarde el mes pasado. Ese conocimiento vive en cabezas, en wikis desactualizadas y en hilos de chat.

Agent Skills es el formato que empaqueta ese conocimiento en una carpeta.

Una carpeta con un archivo SKILL.md dentro: frontmatter YAML con name y description, y debajo instrucciones en Markdown. Opcionalmente scripts, documentos de referencia y plantillas. El agente descubre la carpeta, lee solo la description mientras no la necesita, y carga el resto únicamente cuando la tarea lo pide. Eso es todo el formato.

---
name: revision-de-pull-requests
description: Revisa pull requests siguiendo el checklist del equipo. Úsalo cuando el usuario pida revisar un PR, un diff o cambios antes de mergear.
---

# Revisión de pull requests

## Procedimiento

1. Lee el diff completo antes de comentar nada.
2. Comprueba el checklist de `references/checklist.md`.
3. Agrupa los hallazgos por severidad.

Ese archivo, en una carpeta llamada revision-de-pull-requests/, es un skill válido y completo. La simplicidad es deliberada: el formato lo creó Anthropic y lo liberó como estándar abierto, y hoy lo soportan decenas de clientes distintos —terminales, IDEs, plataformas en la nube, runtimes de agentes— sin que ninguno sea dueño del formato.

A quién sirve este curso

Perfil	Qué se lleva
Quien usa un agente a diario	Deja de repetir las mismas instrucciones en cada sesión: las escribe una vez y el agente las carga sola
Quien lidera un equipo técnico	Convierte convenciones, checklists y procesos en artefactos versionados en git, revisables por PR
Quien publica herramientas	Empaqueta la experiencia de su producto en skills que funcionan en cualquier cliente conforme
Quien construye un agente	Implementa descubrimiento, parseo, activación y ejecución de skills según la especificación

No hace falta ser desarrollador para escribir un skill útil: el 80 % del trabajo es prosa en Markdown. Los capítulos que tocan código —scripts, implementación de cliente— están marcados y se pueden saltar.

Antes de empezar

Necesitas:

• Un cliente que soporte skills. Cualquiera de los que lista el showcase oficial: agentes de terminal, extensiones de IDE, plataformas web. El capítulo 11 los recorre. El curso está escrito contra el estándar, no contra un cliente concreto.
• Markdown a nivel básico. Encabezados, listas, bloques de código, enlaces relativos.
• YAML a nivel mínimo. Pares clave-valor y strings. El frontmatter de un skill son seis campos como máximo, y dos son obligatorios.
• Un editor de texto y una carpeta. No hay build, ni bundler, ni compilación, ni registro al que dar de alta nada.

Ayuda tener, pero no es requisito:

• Git. Los capítulos 10 y 12 asumen que sabes clonar un repositorio y hacer commits.
• Bash o Python. Solo para el capítulo 7, donde los skills empaquetan scripts.
• Nociones de cómo funciona la ventana de contexto de un modelo. El curso lo explica cuando hace falta, pero si ya tienes la intuición, el capítulo 8 rinde más.

No necesitas: una API key propia, un servidor, un framework de agentes, ni conocer el protocolo MCP.

Cómo se lee el lenguaje normativo

La especificación usa MUST, SHOULD y MAY con el significado de RFC 2119. Este curso los traduce siempre igual y marca el término original la primera vez que aparece en cada capítulo:

Original	Traducción	Significado
MUST	DEBE	Requisito absoluto. Incumplirlo hace que el skill no sea conforme.
SHOULD	DEBERÍA	Recomendación fuerte. Se puede ignorar con razones, asumiendo el coste.
MAY	PUEDE	Opcional. Ni recomendado ni desaconsejado.

Cuando algo no es normativo sino convención de un cliente concreto, el curso lo dice explícitamente. Esa distinción es la que evita escribir skills que solo funcionan en la herramienta donde los probaste.

Ruta de aprendizaje

flowchart TD
    A["Fundamentos<br/>Cap. 1-4"] --> B["Escribir buenos skills<br/>Cap. 5-9"]
    B --> C["Ecosistema y distribución<br/>Cap. 10-12"]
    A -.->|"solo consumir skills<br/>de terceros"| C
    B --> D["Curso hermano<br/>Agent Plugins Spec"]
    C --> D
    A -.->|"ejemplos reales<br/>en cualquier momento"| E["Curso hermano<br/>Google Skills"]

El bloque 1 define qué es un skill y termina con uno funcionando en tu máquina. El bloque 2 es donde se decide si el skill sirve de verdad. El bloque 3 lo saca de tu carpeta personal y lo pone en manos de otros —o dentro de tu propio agente.

Capítulos

Bloque 1 · Fundamentos

Qué es un skill, cómo está hecho, qué exige la especificación y cómo se construye el primero de punta a punta.

#	Capítulo	Qué cubre
1	Qué son las Agent Skills	Definición literal de la especificación, el problema de contexto procedimental, los tres beneficios declarados, progressive disclosure en tres etapas y la diferencia con prompts de sistema, herramientas, servidores MCP y subagentes
2	Anatomía de un skill	El árbol canónico de un skill, el SKILL.md pieza por pieza, los directorios opcionales scripts/, references/ y assets/, rutas relativas y los errores de estructura más frecuentes
3	La especificación al detalle	Los seis campos del frontmatter con tipos y límites exactos, reglas de nomenclatura del name, resolución de rutas, qué es conforme, qué no y qué queda como comportamiento indefinido
4	Tu primer skill paso a paso	Crear la carpeta, escribir el archivo, ubicarlo donde el cliente lo descubre, comprobar el descubrimiento, forzar la activación para probar y el ciclo editar-recargar-probar

Si solo vas a leer cuatro capítulos, que sean estos. Al terminar el 4 tienes un skill tuyo activándose en tu cliente.

Bloque 2 · Escribir buenos skills

La diferencia entre un skill que existe y un skill que el agente usa bien. Es el bloque más largo del curso porque es donde está el trabajo real.

#	Capítulo	Qué cubre
5	Escribir buenas instrucciones	Acotar el alcance, calibrar el nivel de detalle y el grado de control, cuándo dividir un skill en varios, seis patrones reutilizables de estructura y antipatrones lado a lado
6	La description	Por qué la description decide si el skill dispara, cuatro principios de redacción, ejemplos antes y después, sets de eval de disparo, medición del trigger rate y splits de train y validation
7	Scripts y comandos	Cuándo un script gana a la prosa, cómo se referencian y ejecutan con rutas relativas, dependencias declaradas inline, diseño de la interfaz para uso agéntico y qué garantías de seguridad NO da el estándar
8	Referencias y recursos	Sacar el contenido pesado del SKILL.md hacia references/ y assets/, disparadores de carga, estrategia de partición por capas de coste y cómo medir la huella de contexto real
9	Evaluar la calidad	Casos de prueba, corridas con skill y sin skill como baseline, assertions, grading con evidencia, benchmark agregado y el bucle de iteración hasta que el skill está listo

El orden importa aquí: el 5 y el 6 se complementan —uno es el cuerpo, el otro es la puerta de entrada—, y el 9 es lo que convierte los capítulos anteriores en un proceso medible en lugar de una colección de opiniones.

Bloque 3 · Ecosistema y distribución

El skill ya funciona. Ahora tiene que llegar a otras máquinas, a otros clientes y —si estás del otro lado— a tu propio agente.

#	Capítulo	Qué cubre
10	Distribución e instalación	Ámbitos personal, de proyecto y de organización, repositorios de skills en git, instalación desde catálogos públicos, versionado y la frontera exacta entre un skill suelto y un plugin
11	El ecosistema de clientes	Los clientes del showcase oficial agrupados por familia, qué comportamiento fija el estándar, qué queda a criterio de cada cliente y cómo escribir un skill portable de verdad
12	Implementar soporte en tu agente	Descubrimiento, parseo del frontmatter, divulgación del catálogo al modelo, activación, resolución de rutas, ejecución de scripts, manejo de errores y lista de verificación de conformidad

El capítulo 12 es el único que asume que escribes código de agente. Si no es tu caso, puedes cerrar el curso en el 11 sin quedarte nada colgando.

La trilogía de cursos

Agent Skills define el formato de una unidad de conocimiento. Alrededor de ese formato hay dos capas más que tienen su propio curso, y juntas cubren el ciclo completo: escribir, empaquetar y estudiar ejemplos reales.

flowchart LR
    A["Agent Skills<br/>El formato"] --> B["Agent Plugins Spec<br/>El empaquetado"]
    A --> C["Google Skills<br/>El catálogo real"]
    C -.->|"ejemplos que<br/>validan lo aprendido"| A
    B -.->|"distribuye<br/>conjuntos de skills"| A

Este curso · Agent Skills

La unidad. Qué es un SKILL.md, qué exige la especificación, cómo se escribe uno que el agente active en el momento correcto y cómo se mide si funciona. Todo lo que aprendes aquí es portable: no depende de un cliente ni de un proveedor.

Es el punto de partida obligatorio, porque los otros dos cursos dan por sabido el formato.

Agent Plugins Spec

El empaquetado. Un skill suelto se copia a mano. Cuando tienes cinco skills, dos servidores MCP y quieres que un equipo entero los reciba con un comando, necesitas una capa por encima: un plugin, con su manifiesto plugin.json, su versionado, su validación en CI y sus marketplaces.

Ese curso cubre desde el primer plugin hasta gobernanza y distribución, e incluye un capítulo dedicado a empaquetar skills dentro de un plugin —la costura exacta entre ambos estándares.

Léelo después de este, y en concreto después del capítulo 10, que es donde este curso marca la frontera entre “skill suelto” y “plugin”.

Google Skills

El catálogo real. Google publicó un catálogo oficial con más de 100 skills reales: fundamentos de Google Cloud, soluciones, AI/ML, infraestructura, datos y analítica, publicidad. No son ejemplos de juguete de una página, son skills en producción escritos por el proveedor de la plataforma que documentan.

Es el mejor material que existe hoy para contrastar la teoría contra la práctica: cómo se ve una description cuando compite con otras cien, cómo se particiona un skill grande en referencias, qué convenciones aparecen cuando alguien mantiene un catálogo a escala.

Léelo en cualquier momento a partir del capítulo 4. Funciona igual de bien como lectura paralela —abriendo un skill del catálogo cada vez que aquí se explica una técnica— que como cierre después del capítulo 9.

Orden recomendado

Orden	Curso	Por qué ahí
1º	Agent Skills (este)	Define el formato que los otros dos usan y asumen conocido
2º	Google Skills	Ejemplos reales que consolidan lo aprendido; se puede leer en paralelo desde el capítulo 4
3º	Agent Plugins Spec	Solo tiene sentido cuando ya tienes varios skills que distribuir

Si tu objetivo inmediato es distribuir a un equipo, invierte el 2º y el 3º. Si tu objetivo es escribir mejores skills, el orden de la tabla es el que rinde más.

Qué vas a saber hacer al terminar

Al cerrar el capítulo 12 deberías poder, sin volver a consultar la documentación:

Escribir

• Crear un skill desde cero con la estructura correcta y verlo activarse en tu cliente.
• Escribir un frontmatter conforme sabiendo de memoria qué campos existen, cuáles son obligatorios y cuáles son los límites duros de cada uno.
• Redactar una description que dispare en las tareas correctas y se quede callada en las demás, en lugar de una que describa el skill sin decir cuándo usarlo.
• Calibrar el nivel de detalle de las instrucciones: cuándo dar libertad al modelo y cuándo imponer un procedimiento paso a paso.
• Decidir si algo va en el cuerpo del SKILL.md, en references/, en assets/ o en un script, y justificar la decisión en términos de coste de contexto.

Medir

• Montar una batería de evals de disparo y medir el trigger rate de tu description.
• Montar una batería de calidad con corridas con skill y sin skill, para saber si el skill aporta algo o solo ocupa contexto.
• Escribir assertions y calificar salidas con evidencia, no con impresiones.
• Iterar sobre el skill con un bucle cerrado en lugar de a ojo, y saber cuándo parar.

Distribuir

• Elegir el ámbito correcto —personal, proyecto u organización— para cada skill.
• Mantener un repositorio de skills en git con versionado y control de cambios.
• Instalar skills de catálogos públicos y auditarlos antes de dejarlos actuar.
• Escribir skills portables que no dependan de convenciones de un solo cliente.
• Saber en qué momento un conjunto de skills debe convertirse en un plugin.

Implementar

• Añadir soporte de Agent Skills a un agente propio: descubrir, parsear, divulgar el catálogo, activar y gestionar el contexto en el tiempo.
• Ejecutar scripts de un skill sin asumir garantías de seguridad que el estándar no da.
• Verificar la conformidad de tu implementación contra una lista de comprobación.

Cómo usar este curso

1. Lee los capítulos 1 a 4 en orden y sin saltarte el 4. El capítulo 4 es práctico: si lo lees sin ejecutarlo, el resto del curso se vuelve abstracto.
2. Ten un skill propio en marcha mientras lees el bloque 2. Cada capítulo del 5 al 9 propone un cambio concreto; aplicarlos sobre un skill real vale más que leerlos.
3. El capítulo 6 y el 9 se refuerzan. El 6 mide si el skill dispara, el 9 mide si el resultado es mejor. Son dos preguntas distintas y necesitan dos baterías distintas.
4. El bloque 3 se puede leer salteado. El 10 interesa a todo el mundo, el 11 a quien trabaja con más de un cliente, el 12 solo a quien construye agentes.
5. Todo dato normativo del curso sale de la especificación oficial. Cuando el curso dice “convención” en lugar de “norma”, esa distinción es intencional y conviene respetarla al escribir tus propios skills.

Glosario mínimo

Estos términos aparecen desde el primer capítulo. Si alguno te suena nuevo, el curso lo define en detalle donde toca:

Término	Qué significa aquí
Skill	Un directorio que contiene, como mínimo, un archivo SKILL.md
SKILL.md	El único archivo obligatorio: frontmatter YAML más cuerpo Markdown
Frontmatter	El bloque YAML entre --- al inicio del archivo, con los metadatos
Progressive disclosure	Cargar información por etapas: primero metadatos, luego cuerpo, luego recursos
Disparo o activación	El momento en que el agente decide leer el cuerpo de un skill
Trigger rate	Porcentaje de casos de prueba en los que el skill se activa como se esperaba
Cliente	Cualquier producto que descubre y ejecuta skills conforme al estándar
Conforme	Que cumple todos los requisitos MUST de la especificación
Plugin	Unidad de empaquetado que agrupa skills y servidores MCP con su propio manifiesto

Fuentes

El curso está escrito contra la documentación oficial del estándar y su repositorio: la especificación, la guía de creación de skills —quickstart, buenas prácticas, optimización de descriptions, uso de scripts y evaluación—, la página de implementación para clientes y el showcase de clientes que lo soportan.

Cuando un capítulo cita texto normativo, lo hace en su idioma original seguido de la traducción, para que puedas contrastar contra la fuente sin ambigüedad.

Resumen

• Agent Skills es un estándar abierto creado por Anthropic para empaquetar contexto procedimental en carpetas portables que cualquier agente conforme puede descubrir y usar.
• Un skill es un directorio con un SKILL.md: frontmatter YAML con name y description obligatorios, más instrucciones en Markdown. Todo lo demás es opcional.
• El curso son 12 capítulos en tres bloques: fundamentos (1-4), escribir buenos skills (5-9) y ecosistema con distribución (10-12).
• Forma una trilogía con Agent Plugins Spec —la capa de empaquetado— y Google Skills —el catálogo oficial con más de 100 skills reales.
• Requisitos reales: Markdown, YAML básico y un cliente que soporte skills. Nada de build, bundler ni registro.
• Todo dato normativo sale de la especificación, y el curso distingue siempre entre lo que DEBE cumplirse, lo que DEBERÍA cumplirse y lo que un cliente PUEDE decidir por su cuenta.

Empieza por Qué son las Agent Skills →