O problema

• Repetir no prompt toda vez: caro e esquecível
• Colocar tudo no AGENTS.md: o arquivo incha e o agente para de ler
• A resposta é carregar sob demanda

O que é uma skill

• Nível 1: só nome e descrição ficam sempre no contexto
• Nível 2: o corpo do SKILL.md entra se for relevante
• Nível 3: arquivos referenciados são abertos se precisar

A anatomia real de uma skill

• Estudo de 238 skills reais, com taxonomia de 13 componentes principais
• O SKILL.md tem metadados obrigatórios e um corpo livre, a cargo do autor
• Liberdade total no corpo significa qualidade muito desigual

From Anatomy to Smells, 2026, arXiv:2607.01456

Quando usar o quê

• Prompt: vale para uma tarefa só
• AGENTS.md: convenção que vale para o repositório inteiro
• Skill: procedimento com passos, que se repete
• Servidor MCP: quando o agente precisa agir sobre um sistema externo

Skill é código de terceiros

26,1% de 31 mil skills públicas analisadas têm ao menos uma vulnerabilidade. Voltamos a isso na aula 10.