Capacidades Modulares para Agentes de IA

¿Qué son las Agent Skills?

Agent Skills son carpetas de instrucciones, scripts y recursos que los agentes de IA pueden descubrir y cargar bajo demanda para realizar tareas especializadas con mayor precisión y eficiencia.

A diferencia de las instrucciones que siempre están activas, las Skills se activan solo cuando son relevantes para la tarea actual. Puedes instalar muchas Skills sin saturar la ventana de contexto del agente, porque este carga únicamente lo que necesita en cada momento.

El estándar Agent Skills fue desarrollado originalmente por Anthropic y publicado como un estándar abierto, actualmente adoptado por más de 20 herramientas y agentes de IA.

¿Qué pueden habilitar las Agent Skills?

Capacidad	Descripción
Expertise de dominio	Empaqueta conocimiento especializado en instrucciones reutilizables: desde procesos de revisión legal hasta pipelines de análisis de datos
Nuevas capacidades	Da a los agentes capacidades que no tienen por defecto (crear presentaciones, construir servidores MCP, analizar datasets)
Flujos de trabajo repetibles	Convierte tareas multi-paso en workflows consistentes y auditables
Interoperabilidad	Reutiliza la misma skill en distintos agentes y herramientas compatibles

Cómo Funcionan: Carga Progresiva

La arquitectura de Skills usa carga progresiva para mantener eficiente la ventana de contexto:

Nivel	Cuándo carga	Tamaño aproximado	Contenido
Metadatos	Siempre (al iniciar)	~100 tokens	`name` y `description` del frontmatter YAML
Instrucciones	Cuando la skill se activa	< 5k tokens	Cuerpo del `SKILL.md` con instrucciones y guías
Recursos	Según se necesiten	Sin límite fijo	Archivos adicionales accedidos o scripts ejecutados

Esta arquitectura de tres niveles significa que puedes tener muchas Skills instaladas sin afectar el rendimiento: el agente accede exactamente a lo que necesita, cuando lo necesita.

Estructura de una Skill

Cada skill es un directorio que contiene un archivo SKILL.md como mínimo:

mi-skill/
├── SKILL.md          # Requerido: instrucciones principales
├── docs/             # Opcional: documentación adicional
│   └── avanzado.md
├── templates/        # Opcional: plantillas de código o configuración
│   └── config.yaml
└── scripts/          # Opcional: scripts de automatización
    └── validar.py

El archivo SKILL.md

El archivo SKILL.md tiene dos partes: metadatos (frontmatter YAML) e instrucciones (cuerpo Markdown).

markdown

---
name: nombre-del-skill
description: Descripción clara de qué hace y cuándo activarse.
---

# Nombre del Skill

Instrucciones detalladas que el agente seguirá cuando esta skill se active.

## Pasos

1. Primero, hacer esto
2. Luego, hacer aquello
3. Para uso avanzado, ver [avanzado.md](docs/avanzado.md)

Campos requeridos

Campo	Obligatorio	Descripción
`name`	Sí	Identificador único en kebab-case (ej: `webapp-testing`). Debe coincidir con el nombre del directorio. Máximo 64 caracteres.
`description`	Sí	Describe qué hace y cuándo activarse. Es el factor más crítico: determina si el agente activa la skill o no. Máximo 1024 caracteres.
`argument-hint`	No	Texto de ayuda que aparece en el chat cuando la skill se invoca como comando slash
`user-invocable`	No	Si la skill aparece en el menú `/`. Por defecto `true`

Cómo Crear una Skill en 5 Pasos

1. Define el problema concreto

Antes de escribir nada, clarifica qué problema resuelve tu skill. Las mejores skills abordan necesidades concretas con resultados medibles.

✅ "Extraer tablas de PDFs y convertirlas a CSV para flujos de análisis de datos"

❌ "Ayudar con mis cosas de finanzas"

Pregúntate: ¿Qué tarea específica resuelve? ¿Qué la activa? ¿Cómo es el éxito?

2. Escribe un nombre claro

Usa minúsculas con guiones (kebab-case). Que sea corto, descriptivo y específico.

pdf-extractor       ✅
brand-guidelines    ✅
aws-cdk-deploy      ✅
misc-helpers        ❌ (demasiado genérico)
my_skill            ❌ (sin guiones bajos)

3. Escribe una descripción que dispare correctamente

La descripción es el componente más crítico. Determina cuándo el agente activa la skill.

Descripción débil:

Esta skill ayuda con PDFs y documentos.

Descripción fuerte:

Toolkit completo de manipulación de PDFs para extraer texto y tablas, crear nuevos PDFs,
fusionar/dividir documentos y gestionar formularios. Úsala cuando Claude necesite rellenar
un formulario PDF o procesar, generar o analizar documentos PDF a escala. Para flujos de
trabajo de documentos y operaciones en lote. No para visualización simple o conversiones básicas.

4. Escribe las instrucciones principales

Usa Markdown con estructura clara: encabezados, listas y bloques de código con ejemplos concretos. Incluye:

Visión general del flujo
Prerrequisitos
Pasos de ejecución
Ejemplos de entrada/salida esperada
Manejo de errores y limitaciones

5. Sube o instala tu skill

Dependiendo de la herramienta que uses:

Claude Code: Crea un directorio skills/ en la raíz del proyecto:

mi-proyecto/
└── skills/
    └── mi-skill/
        └── SKILL.md

VS Code / GitHub Copilot: Usa .github/skills/ o .claude/skills/ en tu repositorio.

Cline: Usa .cline/skills/ (por proyecto) o ~/.cline/skills/ (global).

Archivos de Soporte

Las Skills pueden incluir archivos adicionales que el agente accede solo cuando los necesita:

`docs/`

Documentación técnica profunda que sería demasiado extensa para el SKILL.md:

Guías de configuración avanzada
Esquemas de bases de datos y APIs
Instrucciones por plataforma (aws.md, gcp.md, azure.md)

`templates/`

Plantillas de código o configuración para andamiaje de proyectos:

Archivos de configuración (Terraform, Docker Compose, CI/CD)
Scaffolding de código (componentes, fixtures de tests)
Plantillas de documentación

`scripts/`

Scripts para operaciones deterministas donde se requiere comportamiento consistente:

Validación (linting, chequeo de prerrequisitos)
Procesamiento de datos (parsing, formateo)
Cálculos complejos

Los scripts son muy eficientes en tokens: solo su salida entra al contexto, no el código del script. Un script de 500 líneas produce solo un simple "Passed" o mensajes de error, sin consumir tokens en la lógica.

Compatibilidad entre Herramientas

Una skill creada correctamente funciona en todos estos agentes y herramientas:

Claude Code (Anthropic)
GitHub Copilot (VS Code, CLI, coding agent)
Cline
Cursor
Gemini CLI
OpenAI Codex
Amp
Goose (Block)
Roo Code
Kilo Code
Windsurf
Y muchos más compatibles con el estándar agentskills.io

Skills vs. Otras Herramientas

	Skills	Instrucciones	Proyectos	MCP
Qué proporciona	Conocimiento procedimental	Instrucciones momento a momento	Conocimiento de fondo	Conectividad a herramientas
Persistencia	Entre conversaciones	Conversación única	Dentro del proyecto	Conexión continua
Cuándo carga	Dinámicamente, según necesidad	Cada turno	Siempre en el proyecto	Siempre disponible
Puede incluir código	✅ Sí	❌ No	❌ No	✅ Sí
Ideal para	Expertise especializado	Peticiones rápidas	Contexto centralizado	Acceso a datos

Regla general: Las instrucciones dicen "aquí está lo que debes saber". Las Skills dicen "aquí está cómo hacer las cosas".

Mejores Prácticas

Empieza con casos de uso reales: No crees skills especulativos. Construye cuando tienes tareas repetidas. ¿La has hecho al menos 5 veces? ¿La harás 10 veces más? Entonces una skill tiene sentido.
Define criterios de éxito: Dile al agente cómo es una buena salida. Incluye secciones requeridas, estándares de formato y umbrales de calidad.
Usa el Skill-Creator: El skill-creator de Anthropic te guía mediante preguntas para generar la estructura óptima del SKILL.md.
Mantén el SKILL.md bajo 5k tokens (~400-500 líneas): Si necesitas más contenido, usa archivos en docs/ y referencialos.
Trata las skills como documentación viva: Itera en base al uso real. Refina las descripciones si el activado es inconsistente.

Descubrir y Descargar Skills del Ecosistema

No es necesario crear todas las skills desde cero. Existe un ecosistema creciente de skills públicas y reutilizables que puedes instalar en segundos.

skills.sh es el directorio central del ecosistema open de Agent Skills. Funciona como un registro público donde desarrolladores de todo el mundo —desde startups hasta grandes empresas como Microsoft, Vercel o Anthropic— publican sus skills para que cualquiera pueda descubrirlas e instalarlas.

Instalar una skill desde el registro es tan simple como:

bash

npx skills add <owner/repo>

Por ejemplo, para instalar el skill de diseño frontend de Anthropic:

bash

npx skills add anthropics/skills

También puedes explorar el repositorio github/awesome-copilot para encontrar una colección comunitaria de skills, agentes personalizados, instrucciones y prompts.

Siempre revisa las skills descargadas antes de usarlas para verificar que cumplen con tus requisitos y estándares de seguridad.

Capacidades Modulares para Agentes de IA ​

¿Qué son las Agent Skills? ​

¿Qué pueden habilitar las Agent Skills? ​

Cómo Funcionan: Carga Progresiva ​

Estructura de una Skill ​

El archivo SKILL.md ​

Campos requeridos ​

Cómo Crear una Skill en 5 Pasos ​

1. Define el problema concreto ​

2. Escribe un nombre claro ​

3. Escribe una descripción que dispare correctamente ​

4. Escribe las instrucciones principales ​

5. Sube o instala tu skill ​

Archivos de Soporte ​

docs/ ​

templates/ ​

scripts/ ​

Compatibilidad entre Herramientas ​

Skills vs. Otras Herramientas ​

Mejores Prácticas ​

Descubrir y Descargar Skills del Ecosistema ​