Mejores Prácticas para Habilidades de Agente
Una Habilidad que funciona es en gran medida una cuestión de hábito, no de complejidad: el mismo puñado de prácticas aparece en todas las bibliotecas de Habilidades confiables.
La lista a continuación cubre la escritura, el nombramiento y el mantenimiento de Habilidades para que Claude las encuentre cuando debe y solo cuando debe.
1. Escribe la Descripción como un Disparador, No como una Etiqueta
Indica qué hace la Habilidad y cuándo usarla, utilizando las palabras reales que alguien escribiría para solicitar esa tarea, no un nombre de categoría abstracto.
2. Incluye Dos o Tres Frases de Disparador Reales
Una descripción con frases de ejemplo concretas ("actualización semanal", "informe de estado", "resumen del equipo") coincide con una gama más amplia de solicitudes reales que una sola oración genérica.
3. Mantén Cada Habilidad Enfocada en una Tarea
Una Habilidad que intenta cubrir varios trabajos no relacionados produce una descripción más vaga y coincide de manera menos confiable que varias Habilidades estrechas y de propósito único.
4. Prueba con un Lenguaje Natural, No con un Mensaje de Prueba Genérico
Valida una nueva Habilidad utilizando el tipo exacto de solicitud que escribirías en el trabajo real, ya que contra eso es contra lo que el descubrimiento debe tener éxito.
5. Confirma una Coincidencia Antes de Culpar a las Instrucciones
Si la salida no coincide con lo que describe una Habilidad, verifica si la Habilidad se activó antes de revisar su cuerpo: una falla en el descubrimiento y una instrucción incorrecta producen el mismo síntoma.
6. Dale al Cuerpo Pasos Claros y Específicos
Escribe las instrucciones como le explicarías la tarea a un nuevo compañero de equipo capaz: pasos o reglas concretas, no objetivos vagos como "haz esto bien".
7. Mueve el Material de Referencia Largo Fuera del Cuerpo
Mantén las instrucciones de SKILL.md escaneables y coloca plantillas extensas o guías de estilo en un archivo separado incluido al que el cuerpo pueda apuntar.
8. Limita el Acceso a Herramientas Deliberadamente
Establece allowed-tools cuando una Habilidad solo deba poder hacer una parte de lo que permite la superficie; por ejemplo, leer pero no escribir archivos.
9. Dale a las Habilidades un Nombre Estable y Descriptivo
Usa un name que todavía tenga sentido para ti meses después, ya que es por lo que reconocerás la Habilidad al administrar una biblioteca en crecimiento.
10. Evita Descripciones Superpuestas
Compara la descripción de una nueva Habilidad con las existentes; si dos describen un territorio similar, Claude tiene que elegir y el resultado se vuelve menos predecible.
11. Revisa la Descripción Antes del Cuerpo Cuando Algo Se Sienta Mal
La descripción es más barata de probar e iterar que las instrucciones completas, y es la fuente más común de que una Habilidad no se comporte como se espera.
12. Revisa las Descripciones Después de Cambios de Terminología
Un cambio de marca, un informe renombrado o un nuevo proceso pueden romper silenciosamente una descripción que solía coincidir perfectamente; revisa las Habilidades después de cualquier cambio de este tipo.
13. Comienza con tu Tarea Más Repetida
Crea tu primera Habilidad en torno a lo que ya le explicas a Claude con más frecuencia; la recompensa se acumula más rápido allí.
14. Prefiere Varias Habilidades Estrechas Sobre Una Amplia
Dividir una idea amplia en Habilidades distintas, cada una con su propio disparador claro, coincide de manera más confiable que una Habilidad que intenta hacerlo todo.
15. Habilita una Habilidad en Todas las Superficies Donde Realmente la Uses
Una Habilidad habilitada en claude.ai no funciona automáticamente en Claude Code o Cowork; cada superficie necesita su propio paso de habilitación.
16. Poda Periódicamente las Habilidades No Utilizadas
Deshabilita o elimina las Habilidades en las que ya no confías; descripciones más pequeñas y distintas mantienen el descubrimiento más limpio a medida que tu biblioteca crece.
17. Pide a Claude Directamente que Confirme el Descubrimiento
Al probar o depurar, preguntar "¿qué Habilidad usaste para eso?" es una forma rápida y confiable de verificar si realmente ocurrió una coincidencia.
18. Trata una Habilidad como Documentación Viva
Actualiza las instrucciones de una Habilidad de la misma manera que actualizarías cualquier documento de proceso: cuando el proceso real cambia, la Habilidad debería cambiar con él, no quedarse desfasada.
Preguntas Frecuentes
¿Cuál de estas cosas es más importante si solo puedo arreglar una?
- El campo de descripción: las descripciones específicas y con palabras clave de disparador solucionan más problemas de descubrimiento que cualquier otro cambio único.
¿Debería cada Habilidad tener un archivo de referencia incluido?
- No, la mayoría de las Habilidades simples solo necesitan
SKILL.md; los archivos incluidos son para material de referencia genuinamente largo.
¿Cuántas Habilidades son demasiadas?
- No hay un número fijo; el límite práctico es qué tan distintas puedes mantener cada descripción a medida que la biblioteca crece.
¿Es una mala práctica tener dos Habilidades para tareas similares?
- No intrínsecamente, siempre que sus descripciones sean lo suficientemente específicas para mantenerse distintas; el problema es la superposición, no la similitud del tema.
¿Con qué frecuencia debo revisar mi biblioteca de Habilidades?
- Siempre que aparezca un problema de descubrimiento y periódicamente como un hábito general, especialmente después de cambios en el proceso o la terminología.
¿Se aplican estas prácticas de la misma manera en Claude Code, Cowork y claude.ai?
- Sí, las prácticas de escritura y mantenimiento son las mismas en todas partes; solo la habilitación es específica de la superficie.
Relacionado
- ¿Qué son las Habilidades de Agente? - el concepto fundamental detrás de cada práctica anterior
- Cómo Claude Descubre y Carga Habilidades Automáticamente - por qué la calidad de la descripción importa tanto
- Señales de que tu Habilidad no está siendo descubierta por Claude - cómo se ve cuando se omiten estas prácticas
- Anatomía de un Archivo SKILL.md - dónde vive cada una de estas prácticas en el archivo
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.