Skills no NuGet: documentação versionada vira parte da superfície de confiança

A Microsoft está experimentando distribuir skills dentro de pacotes NuGet para entregar a agentes instruções alinhadas à versão da biblioteca.[6] São arquivos SKILL.md com cabeçalho YAML no formato existente, não uma nova categoria de skill.[6] A proposta é reduzir a exploração necessária para descobrir APIs recentes ou pouco conhecidas.[6]

A ideia tem um benefício claro de desenho: aproximar a instrução do artefato executável. Mas também exige uma pergunta de segurança: quem ganhou autoridade para orientar o agente quando uma dependência foi instalada?

O que muda para quem desenvolve

Segundo o artigo, dotnet restore traz o pacote com suas instruções, e project.assets.json permite descobrir skills no grafo de dependências.[6] O dotnet-inspect lista e imprime esse material; o dotnet-package-skills copia instruções das dependências diretas para .agents/skills, permitindo revisão e versionamento.[6]

Minha leitura é que há duas estratégias distintas. Consultar o pacote mantém a documentação próxima da versão resolvida. Copiar para o repositório oferece um ponto visível de revisão, mas cria uma obrigação de sincronização. Eu escolheria conscientemente onde ficará a fonte de verdade, em vez de misturar as duas opções sem regra.

A cópia precisa ser atualizada quando as referências de pacotes mudam.[6] Por isso, recomendo que a revisão de dependências inclua também o diff das instruções destinadas ao agente.

Como aplicar

Escolha uma tarefa pequena com uma biblioteca específica: produzir uma saída formatada ou escrever um teste de integração. Compare duas execuções com o mesmo modelo e a mesma versão do pacote, uma com a skill e outra sem ela.

Defina antecipadamente o que será medido: compilação, aderência à API instalada, resultado funcional, tempo, tokens e correções humanas. Não avalie apenas se o texto gerado parece mais confiante. Repita a comparação em algumas tarefas para reduzir a influência de um exemplo favorável.

Antes de carregar instruções, revise seu escopo. Eu rejeitaria pedidos para alterar políticas do agente, acessar segredos ou executar operações sem relação com a biblioteca. Para dependências transitivas, prefira descoberta e carregamento seletivos, não confiança automática em todo o grafo.

Cuidados e limites

Os autores ressaltam que uma skill pode melhorar um modelo mais barato e aumentar o custo de outro mais capaz; eficácia e eficiência precisam ser medidas.[6] O NuGet MCP ainda não tinha suporte específico a skills, e a integração estava nos planos.[6]

O artigo apresenta mecanismos de empacotamento e descoberta, não compatibilidade universal pronta com todos os agentes.[6] Minha recomendação é tratar a adoção como uma mudança de contrato e de confiança. Documentação útil explica como usar uma API. Não deveria ganhar, por estar dentro de um pacote, permissão para redefinir o objetivo da execução.

Fonte

[6] Fonte: Microsoft .NET Blog