Capa de Herramientas | Lab Notes — Daniel Conejo Sobrino

Herramientas CLI, adaptadores MCP, skills, especificaciones, AutoSkills y patrones para crear nuevas herramientas.

La capa de herramientas convierte las tareas repetibles en capacidades invocables. Algunas son utilidades locales centradas en CLI; otras son adaptadores de servicios externos expuestos mediante MCP. En ambos casos, el objetivo es evitar que el agente dependa solo del razonamiento generativo.

Herramientas Locales

El toolkit local actúa como capa base. Incluye:

tools.json como índice de herramientas;
README.md como guía general;
AGENTS.md con las reglas para agentes;
SKILL.md para activar el toolkit;
stack-template/bootstrap.py para crear nuevas herramientas;
utilidades auxiliares de telemetría de uso;
la documentación del trabajador de investigación en segundo plano.

Adaptadores MCP

No todas las herramientas son utilidades CLI locales. Algunas capacidades se exponen mediante adaptadores MCP, especialmente cuando el sistema necesita consultar servicios externos de investigación. Esto mantiene el código específico del proveedor detrás de una frontera estable y permite que los agentes traten la investigación externa como otra capacidad invocable.

Estructura Estándar de una Herramienta

Para las utilidades CLI locales, la estructura estándar es:

tool-name/
|-- main.py
|-- lib.py
|-- requirements.txt
|-- package.json
|-- pyproject.toml
|-- README.md
|-- SKILL.md
|-- TOOL.md
`-- tests/

Cada archivo cumple una función:

Archivo	Propósito
`main.py`	Punto de entrada CLI ejecutable.
`lib.py`	Lógica de dominio cuando la herramienta crece.
`requirements.txt`	Dependencias mínimas de Python.
`package.json`	Integración con AutoSkills.
`pyproject.toml`	Configuración moderna de Python.
`README.md`	Uso para personas.
`SKILL.md`	Uso para el agente: cuándo activarla y cómo ejecutarla.
`TOOL.md`	Especificación técnica previa a la implementación.
`tests/`	Verificación básica o avanzada.

Flujo de Creación

Loading diagram…

Flujo de creación de herramientas: especificar, generar la estructura, implementar, testear, registrar y revisar.

Herramientas de Medios

El toolkit de medios aplica el mismo patrón a un dominio concreto: la búsqueda y gestión de películas y series.

Herramienta	Función
`torrent-finder`	Buscar fuentes por título, año, calidad o códec.
`subtitle-finder`	Buscar subtítulos.
`dubbed-finder`	Detectar versiones con audio doblado.
`media-info`	Extraer metadatos técnicos de vídeo.
`media-organizer`	Organizar los medios descargados.

Por qué CLI Primero

Un enfoque centrado en la línea de comandos aporta:

reproducibilidad;
facilidad para escribir tests;
ejecución tanto por personas como por agentes;
logs y errores observables;
integración sencilla con otros flujos de trabajo;
menos dependencia de las interfaces visuales.

Lección Principal

Una herramienta para agentes no debería ser solo código. Debería incluir su forma de descubrirse, su contrato de uso, su contexto para el agente y su estrategia de verificación.