Ag
Guías

¿Qué es un skill?

Un skill es una carpeta con SKILL.md: el agente la usa solo cuando la tarea encaja. Qué son, dónde van y un ejemplo.

~3 min lectura Revisado el 10 de julio de 2026
Cursor Claude Code GitHub Copilot OpenAI Codex VS Code Gemini CLI OpenCode Cline Antigravity Principiante estándar

En una línea

Un skill es una mini-guía empaquetada: carpeta con SKILL.md que le dice al agente cómo hacer una tarea concreta (review de PR, migración, checklist…). El agente no la carga siempre; la abre cuando tu petición encaja con su descripción.

No confundir con reglas (siempre activas) ni con MCP (conexión a herramientas externas). Comparación: Skills vs reglas vs MCP.

Qué contiene

mi-skill/
├── SKILL.md      # obligatorio: nombre, descripción, instrucciones
└── scripts/      # opcional: scripts que el agente puede ejecutar

El archivo clave es SKILL.md. El estándar abierto se llama Agent Skills — ahí está el formato oficial y el enlace a agentskills.io.

Cómo funciona en la práctica

  1. Tú pides algo: “Revisa este PR” o “Audita accesibilidad de esta página”.
  2. El agente compara tu petición con la descripción de cada skill disponible.
  3. Si encaja, lee el SKILL.md y sigue esos pasos.
  4. Si no encaja, ignora ese skill.

Por eso la descripción del frontmatter importa tanto: es lo que el agente usa para decidir si abrirlo.

Ejemplo mínimo

---
name: review-pr
description: Revisa un pull request: bugs, tests faltantes y convenciones del repo.
---

1. Lee el diff y los archivos tocados.
2. Comprueba tests si cambia lógica de negocio.
3. Lista hallazgos por severidad (bloqueante / sugerencia).

Copia la carpeta a la ruta de skills de tu plataforma (abajo). No hace falta “instalar” un paquete npm solo por ser skill.

Dónde van (según plataforma)

PlataformaUbicación habitual
Cursor.cursor/skills/<nombre>/
Claude Code.claude/skills/ o ~/.claude/skills/
VS Code / Copilot.github/skills/
Gemini CLIsegún doc oficial
OpenCodesegún doc OpenCode

Detalle por editor o agente en Plataformas.

Cuándo crear o instalar un skill

  • Repites la misma tarea (review, deploy, migración) y quieres pasos fijos.
  • Encontraste un skill de la comunidad que describe un flujo que te sirve (ej. en el catálogo abajo).

Cuándo no

  • Convenciones del stack que aplican a todo el repo → mejor reglas o AGENTS.md.
  • Conectar con browser, DB o docs externas → MCP.
  • Primer día con IA → primero empezar y contexto del repo.

Catálogo en Agentoteca

En /skills/ listamos algunos skills y referencias (ponytail, ui-skills, estándar Agent Skills…). No es exhaustivo: son resúmenes en español + enlace al repo oficial para que no tengas que leer todo el README antes de decidir.