Saltar al contenido

¿Qué es un Agent Skill?

Introducción al formato de Agent Skills y cómo los agentes de IA los usan.

Un Agent Skill es un archivo de instrucciones (SKILL.md) que enseña a un agente de IA una nueva capacidad sin reentrenarlo.

Cómo funcionan

  1. Tú (o tu equipo) escribe un SKILL.md con instrucciones, ejemplos y material de referencia.
  2. El agente (Claude Code, Claude API, o similar) detecta automáticamente cuándo el skill es relevante al contexto —gracias al campo description del frontmatter.
  3. El agente carga el skill bajo demanda y sigue sus instrucciones.

Anatomía de un SKILL.md

---
name: fit-ejemplo
description: Cuándo el agente debería activar este skill — redactado como condición.
---

# fit-ejemplo

## Cuándo usar este skill
## Instrucciones
## Ejemplos
## Referencias

El campo description es crítico: es lo que el agente lee para decidir si el skill aplica al contexto actual. Redáctalo pensando en “¿bajo qué señales quiero que se active?”.

Límites y buenas prácticas

  • Mantén el SKILL.md bajo 500 líneas. Si excede, divide en archivos auxiliares (reference.md, scripts/).
  • Un skill hace una cosa bien. No apiles responsabilidades en un solo skill.
  • Guía, no programes. Deja margen al criterio del agente.

Referencias