Una habilidad empaqueta un flujo de trabajo reutilizable bajo demanda para un agente de IA: instrucciones para una tarea recurrente (cuándo hacerlo y cómo), más scripts o recursos opcionales que el agente carga solo cuando la tarea es relevante. Es la diferencia entre reexplicar un procedimiento cada vez y enseñarlo una sola vez.
SKILL = a self-contained folder the agent can pull in on demand:
SKILL.md → metadata + instructions (the TRIGGER + the STEPS)
scripts/ → optional helper scripts the agent runs (e.g. a linter, a generator)
resources/ → optional templates, examples, reference files
→ loaded ONLY when relevant → keeps the base context small, the workflow repeatable
El beneficio es la divulgación progresiva: el agente sabe que la habilidad existe a partir de una descripción breve, y obtiene las instrucciones completas y los scripts solo cuando aparece una tarea coincidente — así docenas de habilidades no inflaman cada conversación.
Una habilidad tiene tres partes: el disparador (cuándo), los pasos (cómo) y cualquier script auxiliar (herramientas). Mantenla enfocada y componible — un trabajo hecho bien, no una colección de todo.
---
name: changelog-entry
description: Add a CHANGELOG entry. Use when finishing a user-facing change.
---
# Add a changelog entry
## Steps
1. Read the latest commits since the last release tag.
2. Categorize each as Added / Changed / Fixed.
3. Prepend a dated section to CHANGELOG.md under [Unreleased].
4. Run `scripts/validate.sh` to check the format.
La description es el disparador — le dice al agente cuándo recurrir a esta habilidad. La lista numerada son los pasos, y validate.sh es un script auxiliar que aplica la corrección para que el agente no tenga que razonar sobre el formato desde cero. Como la habilidad es pequeña y tiene un único propósito, se compone limpiamente con otras (por ejemplo, una habilidad "release" separada puede llamarla).
Las habilidades transforman un agente de un asistente general que constantemente re-explicas en uno que conoce tus procedimientos recurrentes. Al empaquetar el disparador, los pasos y los scripts en una unidad enfocada y componible que se carga solo bajo demanda, codificas el conocimiento institucional una vez y lo reutilizas de forma confiable — obteniendo resultados consistentes en tareas repetitivas sin reexplicarlas y sin pagar el costo del contexto de cada flujo de trabajo en cada solicitud.