¿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.
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.
Resumen
- Idea Central: Una Habilidad es una pequeña carpeta de instrucciones, construida alrededor de un archivo llamado
SKILL.md, que Claude puede descubrir y cargar cuando una tarea coincide con lo que cubre la Habilidad. - Por qué es Importante: Reemplaza la necesidad de escribir el mismo proceso, lista de verificación o estilo de la casa en cada nueva conversación con un paquete reutilizable y portátil que Claude encuentra por sí mismo.
- Conceptos Clave:
SKILL.md, coincidencia de descripción, carga bajo demanda, archivos de referencia empaquetados, portabilidad entre interfaces. - Cuándo Usar: Cualquier tarea que realices de la misma manera repetidamente: un formato de informe recurrente, una lista de verificación de revisión, una convención de nomenclatura, un proceso paso a paso específico para tu equipo.
- Limitaciones / Compensaciones: Una Habilidad solo se activa cuando su descripción coincide claramente con la tarea actual; una descripción vaga o demasiado amplia significa que Claude podría no cargarla nunca, o cargarla cuando no debería.
- Temas Relacionados: Instrucciones Personalizadas, Proyectos, metadatos de
SKILL.md, descubrimiento de Habilidades.
Fundamentos
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.
Mecánica e Interacciones
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.
Consideraciones y Aplicaciones Avanzadas
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.
Conceptos Erróneos Comunes
- "Una Habilidad es básicamente un prompt guardado." - Un prompt guardado es texto que pegas tú mismo; una Habilidad son instrucciones que Claude encuentra y carga por sí solo, sin que tú la nombres.
- "Las Habilidades solo funcionan en Claude Code." - Las Habilidades son portátiles entre Claude Code, Cowork y claude.ai; la misma carpeta se comporta de la misma manera en cada interfaz.
- "Tienes que decirle a Claude qué Habilidad usar." - Normalmente no lo haces; Claude coincide automáticamente la tarea con la descripción de una Habilidad. Aún puedes referenciar una por su nombre si quieres ser explícito.
- "Más Habilidades instaladas significan mejores resultados." - Una gran pila de Habilidades descritas vagamente hace que el descubrimiento sea más difícil, no más fácil, porque las descripciones comienzan a superponerse.
- "Una Habilidad necesita código para ser útil." - Muchas Habilidades útiles son puras instrucciones y reglas de formato sin ningún script o código.
Preguntas Frecuentes
¿Cuál es el mínimo que necesita una Habilidad para existir?
- Una carpeta que contenga un archivo:
SKILL.md, con unnameydescriptionen sus metadatos y instrucciones en el cuerpo. - Los archivos de referencia o scripts empaquetados son adiciones opcionales, no requisitos.
¿Tengo que decirle a Claude que use una Habilidad específica?
- No, Claude compara las nuevas tareas con las descripciones de tus Habilidades disponibles y carga una coincidencia automáticamente.
- Aún puedes nombrar una Habilidad directamente en tu mensaje si quieres forzarla o ser explícito sobre cuál quieres decir.
¿Cómo se diferencia una Habilidad de simplemente pegar instrucciones en el chat?
- Las instrucciones pegadas se aplican una vez, a ese mensaje; una Habilidad se guarda y se recarga automáticamente cada vez que surge una tarea coincidente, en cualquier conversación.
¿Se puede usar la misma Habilidad en Claude Code y claude.ai?
- Sí, las Habilidades son portátiles entre Claude Code, Cowork y claude.ai, por lo que una Habilidad construida una vez no necesita ser reconstruida por interfaz.
¿Qué sucede si ninguna Habilidad coincide con mi solicitud?
- Claude simplemente responde normalmente, sin cargar ninguna instrucción de Habilidad; las Habilidades solo se agregan a una conversación cuando hay una coincidencia.
¿Puede una Habilidad incluir un script o un archivo de referencia, no solo instrucciones?
- Sí, la carpeta de una Habilidad puede empaquetar un documento de referencia con detalles adicionales, o un script que la Habilidad tiene permitido ejecutar, junto con
SKILL.md.
¿Para qué sirve el campo `allowed-tools`?
- Es un campo opcional de metadatos que limita qué herramientas tiene permiso para invocar una Habilidad, lo cual es más relevante en Claude Code y Cowork.
¿Por qué el campo de descripción es tan importante?
- Es lo que Claude compara con las tareas entrantes; una descripción vaga significa que la Habilidad puede no cargarse nunca, aunque las instrucciones internas estén bien.
¿Qué tipo de tareas son buenas primeras Habilidades?
- Los informes recurrentes con un formato fijo, las listas de verificación de revisión o control de calidad, y los recorridos de incorporación son las primeras Habilidades más comunes que los equipos construyen.
¿Es una Habilidad lo mismo que un Proyecto?
- No; un Proyecto es contexto y archivos persistentes limitados a un espacio de trabajo, mientras que una Habilidad es una receta activada por tareas que puede aplicarse en cualquier conversación.
¿Es una Habilidad lo mismo que las Instrucciones Personalizadas?
- No; las Instrucciones Personalizadas se aplican a todas las conversaciones todo el tiempo, mientras que una Habilidad solo se carga cuando su descripción coincide con la tarea actual.
¿Necesito saber programar para construir una Habilidad?
- No; el núcleo de una Habilidad es un archivo
SKILL.mdcon instrucciones en lenguaje natural; los scripts empaquetados son opcionales y no son necesarios para la mayoría de las Habilidades.
Relacionado
- Fundamentos de las Habilidades de Agente - instala tu primera Habilidad y observa el descubrimiento en la práctica
- Cómo Claude Descubre y Carga Habilidades Automáticamente - una mirada más cercana al mecanismo de coincidencia de descripciones
- Habilidades vs Proyectos vs Instrucciones Personalizadas: ¿Cuál es la Diferencia - cuándo elegir cada una
- Anatomía de un Archivo SKILL.md - qué va en los metadatos y el cuerpo
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.