¿Qué son las Agent Skills?
Las Agent Skills son carpetas con instrucciones, scripts y archivos de referencia que enseñan a un agente a hacer un trabajo concreto. Cada skill gira en torno a un archivo SKILL.md, y el agente carga una skill solo cuando la tarea del momento lo requiere.
Cómo se estructura una skill
Una skill es una carpeta con su nombre. El frontmatter YAML de SKILL.md contiene los campos name y description, y el cuerpo contiene instrucciones paso a paso. La carpeta también puede incluir scripts, plantillas o documentos de referencia.
- En Claude Code, las skills personales están en ~/.claude/skills/ y las del proyecto en .claude/skills/.
- Codex también admite skills: las del proyecto están en .agents/skills y las personales en ~/.codex/skills.
- Los plugins también pueden traer skills.
Por qué las skills se cargan poco a poco
Al principio, solo el nombre y la descripción breve de cada skill entran en el contexto del modelo. Cuando una tarea coincide con una skill, el modelo lee el SKILL.md completo y, si hace falta, los archivos que lo acompañan. Así el contexto se mantiene pequeño aunque haya decenas de skills instaladas, pero una skill con una descripción vaga no se activará en el momento adecuado.
Skills, MCP, subagentes y hooks
Estos cuatro se confunden mucho; cada uno resuelve un problema distinto.
- Skill: conocimiento y scripts para un trabajo; el modelo decide cuándo usarla.
- MCP: añade herramientas nuevas y conexiones con servicios externos.
- Subagente: un agente auxiliar que trabaja en un contexto separado.
- Hook: un comando que se ejecuta ante un evento determinado cada vez, sin depender del modelo.
Cómo escribir una buena skill
Una skill es tan útil como su capacidad de activarse en el momento justo y de mantenerse breve.
- En description, di con claridad qué hace la skill y cuándo usarla.
- Mantén SKILL.md corto y pasa las referencias largas a archivos aparte.
- Convierte los pasos exactos y repetidos en scripts para que el modelo no los reescriba cada vez.
- Lee las skills de otras personas antes de instalarlas; sus scripts se ejecutan en tu máquina.
Skills en AgentVera
La galería de skills de AgentVera reúne en una sola lista las skills de Claude Code y Codex que hay en tu equipo, y los perfiles de contexto te permiten controlar cuánto añaden las skills a la primera petición.
- “Details → Automation → Skills”: crea, activa, desactiva, edita o copia a otro agente las skills de Claude Code y Codex.
- En las skills instaladas desde la galería se comprueban los archivos con SHA-256 y se analizan en tu equipo antes de instalarlas; los scripts nunca se vuelven ejecutables.
- Compartir tus propias skills con tu organización o con la galería pública está incluido en los planes Pro y Team; las skills públicas pasan por la aprobación de un moderador.
- El perfil de contexto “Lean” desactiva los plugins, hooks, skills y MCP externos del usuario, y reduce la primera petición de Claude Code de unos 34,4k a 13,3k tokens.
Preguntas frecuentes
¿Qué diferencia hay entre una skill y MCP?
MCP da a un agente herramientas y conexiones nuevas; una skill le enseña a hacer un trabajo. Una skill incluso puede describir cómo usar herramientas MCP por el camino.
¿Las skills consumen tokens en cada petición?
Solo sus nombres y descripciones están en el contexto en cada petición. El contenido completo se carga cuando el modelo decide usar la skill.
¿Cómo consigo que el agente use una skill?
Normalmente no tienes que hacer nada; el modelo carga una skill cuando la tarea coincide con su descripción. También puedes mencionar la skill por su nombre en tu mensaje y pedir al agente que la use.
¿Es seguro instalar la skill de otra persona?
Depende de lo que contenga. Las skills incluyen instrucciones y scripts, y los scripts se ejecutan en tu ordenador. Lee SKILL.md y los scripts antes de instalarla.