Mejores prácticas para el desarrollo de skills
Crear skills de agente efectivos requiere una cuidadosa reflexión sobre la estructura, claridad y reutilizabilidad. Esta guía cubre las mejores prácticas recopiladas de la comunidad y las directrices oficiales.
Estructura tus skills claramente
Un skill bien estructurado es más fácil de seguir para los agentes y de mantener para los humanos.
Usa secciones claras
Organiza tu skill con secciones distintas:
- Resumen - Qué hace el skill
- Prerrequisitos - Qué se necesita antes de usar el skill
- Instrucciones - Guía paso a paso
- Ejemplos - Pares concretos de entrada/salida
- Solución de problemas - Problemas comunes y soluciones
Mantén las instrucciones atómicas
Divide las tareas complejas en pasos simples y secuenciales:
## Instrucciones 1. Analizar el documento de entrada 2. Identificar las secciones clave 3. Extraer información relevante 4. Formatear la salida según la plantilla 5. Validar el resultado
Escribe para la claridad
Recuerda que un agente de IA interpretará tus instrucciones literalmente.
Sé específico
Evita el lenguaje ambiguo:
- ❌ "Procesar el archivo apropiadamente"
- ✅ "Parsear el archivo JSON y extraer todos los objetos con un campo 'status' establecido en 'active'"
Define los términos
Si usas terminología específica del dominio, defínela:
## Definiciones - **Widget**: Un componente de UI que muestra datos de usuario - **Gadget**: Un servicio backend que procesa solicitudes
Incluye ejemplos
Los ejemplos ayudan a los agentes a entender el comportamiento esperado.
Muestra entrada y salida
## Ejemplo ### Entrada Usuario: "Crear un resumen de esta transcripción de reunión" [contenido de la transcripción] ### Salida esperada ## Resumen de la reunión **Fecha**: 10 de enero de 2025 **Participantes**: Alice, Bob, Carol ### Puntos clave 1. Discusión sobre objetivos del T1 2. Revisión de presupuesto aprobada 3. Próxima reunión programada para el 17 de enero
Maneja casos límite
Piensa en qué podría salir mal y proporciona orientación:
## Casos límite - Si la entrada está vacía, responder "No hay contenido para procesar" - Si el formato no es reconocido, pedir aclaración - Si hay múltiples interpretaciones posibles, listarlas y pedir al usuario que elija
Prueba exhaustivamente
Antes de compartir tu skill:
- Prueba con varias entradas
- Prueba casos límite
- Haz que otros lo prueben sin explicación
- Itera basándote en los comentarios
Documenta las dependencias
Lista cualquier herramienta, API u otros skills requeridos:
## Dependencias - Acceso al sistema de archivos - Python 3.9+ - El skill `pdf-parser` para entrada PDF
Versiona tus skills
Mantén un registro de los cambios:
## Registro de cambios ### v1.1.0 (2025-01-10) - Añadido soporte para entrada PDF - Mejorado el manejo de errores ### v1.0.0 (2025-01-01) - Versión inicial
Comparte y colabora
La comunidad se fortalece cuando compartimos:
- Contribuye al directorio Awesome Skills
- Haz tus skills de código abierto en GitHub
- Documenta tu viaje de aprendizaje
- Ayuda a otros a solucionar problemas
Recursos
¡Feliz desarrollo!