tool-design
Installation
SKILL.md
🛠️ Tool Design for Agent Systems
Esta habilidad proporciona los principios para diseñar interfaces que los agentes de IA puedan descubrir, comprender y utilizar con alta fidelidad. A diferencia de las APIs tradicionales para humanos, las herramientas de agentes deben priorizar la desambiguación semántica, la composición atómica y la eficiencia de tokens en las observaciones.
Mental Model: Una herramienta es una extensión del razonamiento del modelo. Si un ingeniero humano no puede distinguir claramente cuándo usar la Herramienta A vs la Herramienta B, el agente tampoco podrá. La claridad descriptiva supera a la sofisticación técnica.
🚩 Fragilidad y Autonomía
- Fragilidad: Media. Una mala descripción de herramienta puede llevar a bucles de llamadas infinitos o argumentos alucinados.
- Libertad: Alta en la implementación técnica de la lógica de la herramienta, pero Baja en la estructura de su definición.
🚀 Cuándo Activar
- Al construir nuevas capacidades para un agente (MCP, Plugins).
- Para depurar fallos recurrentes en las llamadas a herramientas (Tool-Call Failures).
- Al notar que el agente se confunde entre múltiples herramientas similares.
- Para optimizar el uso de tokens en las salidas de herramientas.