¿Qué son las Habilidades de Agente?
Las Habilidades de Agente son recetas basadas en carpetas que Claude carga bajo demanda para guiar cómo lleva a cabo una tarea.
//
Busca en todas las páginas de la documentación
Las Habilidades de Agente son recetas basadas en carpetas que Claude carga bajo demanda para guiar cómo lleva a cabo una tarea.
En lugar de reexplicar tu proceso cada vez que pides un informe semanal, una revisión de código o un recorrido de incorporación, escribes las instrucciones una vez como una Habilidad.
A partir de entonces, Claude reconoce cuándo una solicitud coincide con esa Habilidad y carga automáticamente las instrucciones completas, sin que necesites referenciarla por su nombre.
SKILL.md, que Claude puede descubrir y cargar cuando una tarea coincide con lo que cubre la Habilidad.SKILL.md, coincidencia de descripción, carga bajo demanda, archivos de referencia empaquetados, portabilidad entre interfaces.SKILL.md, descubrimiento de Habilidades.En su forma más simple, una Habilidad es una carpeta.
Dentro de esa carpeta se encuentra un archivo obligatorio, SKILL.md, que contiene un bloque corto de metadatos seguido de instrucciones en lenguaje natural en el cuerpo.
Los metadatos le dicen a Claude cómo se llama la Habilidad y, lo más importante, describen qué hace y cuándo debe usarse.
El cuerpo es donde reside la receta real: los pasos, el formato, las reglas de la casa que deseas que se sigan cada vez que surja este tipo de tarea.
Una Habilidad también puede empaquetar archivos adicionales junto con SKILL.md, como un documento de referencia con más detalles de los que caben en las instrucciones principales, o un pequeño script que la Habilidad tiene permitido ejecutar.
Piensa en una Habilidad como una ayuda de trabajo que le entregas a un nuevo miembro del equipo, excepto que Claude la lee automáticamente en lugar de necesitar que se le indique que la abra.
No invocas una Habilidad de la misma manera que ejecutarías un comando.
Claude escanea las descripciones de todas tus Habilidades disponibles contra la tarea que tiene delante y carga la que coincide.
Esa distinción —una Habilidad se descubre, no se invoca— es lo más importante que hay que entender sobre cómo se comportan las Habilidades en el día a día.
La descripción de una Habilidad está haciendo más trabajo del que parece.
Claude no lee las instrucciones completas de cada Habilidad en cada mensaje; eso sería lento y saturaría la conversación con material irrelevante.
En su lugar, mantiene un índice ligero de para qué sirve cada Habilidad disponible, construido a partir del campo de descripción, y compara las nuevas tareas con ese índice.
Cuando el lenguaje de una tarea se alinea con la descripción de una Habilidad, Claude carga el cuerpo completo de SKILL.md de esa Habilidad en la conversación antes de comenzar a trabajar.
Es por eso que la descripción es más importante que casi cualquier otra cosa sobre una Habilidad: es el disparador, no solo una etiqueta.
Una forma ilustrativa corta de cómo se ven esos metadatos:
---
name: weekly-report
description: >-
Generates the weekly team status report in our standard format.
Use when asked for a weekly update, status report, or team summary.
allowed-tools: []
---Observa que la descripción anterior indica tanto lo que hace la Habilidad como cuándo usarla: nombra las frases desencadenantes que una persona realmente escribiría, no solo una etiqueta de categoría.
Un campo opcional allowed-tools puede limitar qué herramientas tiene permiso para invocar una Habilidad, lo cual es más relevante en Claude Code y Cowork que en la aplicación web claude.ai, donde el acceso a las herramientas ya está restringido por la propia interfaz.
Las Habilidades son portátiles por diseño: la misma carpeta funciona ya sea que Claude se ejecute en Claude Code, en Cowork o en la interfaz de chat de claude.ai, porque el mecanismo subyacente —coincidencia de descripción, luego carga de instrucciones— es el mismo en todas partes.
Las Habilidades se sitúan junto a otras dos formas de dar contexto permanente a Claude: Proyectos e Instrucciones Personalizadas.
Cada una resuelve una forma diferente de problema, y la distinción útil es entre el contexto que siempre debe estar presente y el contexto que solo debe cargarse cuando sea relevante.
| Enfoque | Fortaleza | Debilidad | Mejor Ajuste |
|---|---|---|---|
| Habilidad de Agente | Se carga solo cuando la tarea coincide; portátil entre interfaces | Solo es tan buena como su descripción; invisible si el disparador es vago | Una tarea o proceso recurrente con un disparador claro y nomurable |
| Proyecto | Mantiene archivos y contexto limitados a un espacio de trabajo, siempre disponibles dentro de él | Atado a un solo espacio de trabajo; no es algo que Claude busque al hacer coincidir una descripción | Trabajo continuo ligado a un cliente, base de código o iniciativa |
| Instrucciones Personalizadas | Se aplica ampliamente, en cada conversación, sin necesidad de coincidencia | Siempre activas, por lo que no pueden mantenerse estrechas a una tarea sin convertirse en ruido | Preferencias permanentes que deseas que se sigan todo el tiempo, en todas partes |
Las primeras Habilidades de un equipo suelen ser las tareas que ya realizan de la misma manera cada vez: un informe semanal con una estructura fija, una lista de verificación de revisión de código, un recorrido de incorporación para nuevos empleados.
Estos son buenos puntos de partida porque el disparador es obvio y la recompensa es inmediata: la próxima vez que alguien pida ese informe, Claude ya conocerá el formato sin que se le diga de nuevo.
A medida que crece una biblioteca de Habilidades, la disciplina que más importa es mantener la descripción de cada Habilidad lo suficientemente específica como para que no se superponga de manera confusa con otra Habilidad que cubra un terreno similar.
SKILL.md, con un name y description en sus metadatos y instrucciones en el cuerpo.SKILL.md.SKILL.md con instrucciones en lenguaje natural; los scripts empaquetados son opcionales y no son necesarios para la mayoría de las Habilidades.Versiones de Stack: Escrito contra la línea de modelos de Claude actual a partir de ~junio de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (el predeterminado), y Claude Haiku 4.5. Los nombres de los modelos, los precios y las características del producto cambian rápidamente; verifica los detalles actuales en platform.claude.com/docs antes de confiar en ellos.
Revisado por Chris St. John·Última actualización: 16 jul 2026