Habilidades de Agente en Paquetes npm: Entregando Conocimiento de Biblioteca al Agente

El artículo trata sobre la entrega de Agent Skills, un formato abierto para instrucciones de agentes de IA, a través de paquetes npm. Cuando un agente se encuentra con una nueva biblioteca, explorar el código fuente es efectivo pero ineficiente; el autor conoce lo esencial y puede codificarlo en un archivo SKILL.md dentro de un directorio skills/ en el paquete. Este archivo contiene metadatos YAML e instrucciones, con referencias/ opcionales para detalles. Por ejemplo, @teqfw/db incluye una skill de este tipo que le dice al agente cómo usar el paquete correctamente, evitando APIs privadas, respetando los límites de las transacciones y no haciendo suposiciones durante las reconstrucciones de la base de datos. Agrupar la skill con el paquete npm garantiza que el agente reciba instrucciones acordes a la versión, actualizadas en la instalación y en el rollback. Sin embargo, el simple hecho de tener una skill en node_modules no la habilita automáticamente; los proyectos deben enlazarla explícitamente, por ejemplo, mediante un enlace simbólico en .agents/skills, para controlar qué dependencias pueden influir en el comportamiento del agente. El autor implementa esto en paquetes de TeqFW como @teqfw/di, cfg, cli, log, db y @flancer32/teq-web. Las limitaciones incluyen una posible mala interpretación, skills desactualizadas y la saturación del contexto, por lo que las skills deben ser concisas y complementarias al código, los tipos y el README. El trabajo relacionado incluye el RFC en el repositorio de Agent Skills y el proyecto skills-npm. El autor llama a este patrón 'Dependency-bound Agent Skills'.