Habilidades de Agente em Pacotes npm: Entregando Conhecimento de Biblioteca ao Agente

O artigo discute a entrega de Agent Skills, um formato aberto para instruções de agentes de IA, por meio de pacotes npm. Quando um agente encontra uma nova biblioteca, explorar o código-fonte é eficaz, mas ineficiente; o autor conhece o essencial e pode codificá-lo em um arquivo SKILL.md dentro de um diretório skills/ no pacote. Este arquivo contém metadados YAML e instruções, com referências opcionais/ para detalhes. Por exemplo, @teqfw/db inclui uma skill que diz ao agente como usar o pacote corretamente, evitando APIs privadas, respeitando limites de transação e não fazendo suposições durante reconstruções de banco de dados. Agrupar a skill com o pacote npm garante que o agente receba instruções compatíveis com a versão, atualizadas na instalação e no rollback. No entanto, apenas ter uma skill em node_modules não a ativa automaticamente; os projetos devem explicitamente vinculá-la, por exemplo, via symlink em .agents/skills, para controlar quais dependências podem influenciar o comportamento do agente. O autor implementa isso em pacotes TeqFW como @teqfw/di, cfg, cli, log, db e @flancer32/teq-web. As limitações incluem possível má interpretação, skills desatualizadas e inchaço de contexto, então as skills devem ser concisas e complementares ao código, tipos e README. Trabalhos relacionados incluem RFC no repositório Agent Skills e o projeto skills-npm. O autor chama esse padrão de 'Agent Skills vinculados à dependência'.