Google Cloud propõe cinco regras para avaliar agent skills antes que inflem a janela de contexto
Aprofundamento CEVIU
Aprofundamento
O Google Cloud parte de um diagnóstico simples: muita equipe valida um SKILL.md colando um prompt no chat, vendo passar uma vez no laptop e fazendo merge na main. Sem ciclo de avaliação, três páginas de documentação de CLI em markdown podem confundir um modelo de fronteira tanto quanto ajudá-lo. O texto vem da própria equipe, que mediu o Google Cloud Developer Plugin (skills essenciais mais o servidor MCP Developer Knowledge) em dezenas de cenários com Gemini, Antigravity e outros agentes, usando Claude Sonnet 5 na plataforma Gemini em pods Harbor isolados no GKE Autopilot.
O detalhe técnico que mais pesa é o roteamento: o agente não lê o corpo do SKILL.md no turno zero, só nome e descrição do frontmatter YAML. Por isso, quando o delta entre plugin e baseline é zero, a causa mais comum (segundo o post, nove em dez vezes) é a skill nem ter sido carregada. Com mais de uma dúzia de skills aparecem under-triggering e sibling hijacking. O skill-reach, aberto pelo Google, valida manifests, mede sobreposição de vocabulário e roda probes em Claude Code, Antigravity e OpenAI Codex. Já o SkillSpector da NVIDIA cobre riscos que linters comuns não veem, como prompt injection e tool poisoning.
As regras 2 e 3 tratam de ruído. Laptop traz credenciais em cache, variáveis exportadas e histórico do bash, e a carga de CPU derrubou a nota em testes internos com agentes de code retrieval. Em um estudo de retrieval, mais de um terço das tarefas teve scores diferentes em execuções consecutivas com o mesmo código e prompt. A saída é ablação pareada: o Arm A roda o modelo base em sandbox limpo sem a skill, o Arm B roda o mesmo prompt e sandbox com ela montada. O post ainda traz as regras 4 e 5: separar eficiência e segurança da correção para evitar reward hacking e ensinar hábitos operacionais, não despejar documentação.
O que mudou
O tema conecta com a cobertura recente do plugin. Em 2 de novembro de 2026, o CEVIU noticiou "Plugin google-cloud-developer chega ao Antigravity Marketplace com skills, guardrails e MCP", o anúncio da distribuição do mesmo plugin. Um dia depois, o Google publica como mede se as skills dele valem o custo em tokens. Antes, em 28 de outubro de 2026, o CEVIU registrou "Google detalha como distribui o Agent Skills como produto: seis gates automatizados e agente de IA revisor", que já tratava de quality gates. A avaliação em sandbox pareado é a peça que complementa esse lado.
Por que isso importa
Para quem mantém skills em um repositório de agentes, a leitura é que skill sem medição vira custo fixo de contexto. Rodar a matriz com e sem skill em CI a cada troca de modelo permite apagar o que o modelo novo já faz sozinho. Isso é uma interpretação editorial, mas o argumento do post vai nessa direção.
Linha do tempo
CEVIU noticia seis gates automatizados e agente revisor na distribuição do Google Agent Skills.
Plugin google-cloud-developer chega ao Antigravity Marketplace.
Google Cloud publica cinco regras para avaliar agent skills antes que inflem o contexto.
Perguntas frequentes
Por que uma skill pode não melhorar o resultado do agente?
Muitas vezes o agente nem carregou a skill. O roteador só lê nome e descrição no frontmatter YAML. Se a descrição fala de implementação interna ou outra skill intercepta o prompt, o corpo do SKILL.md nunca entra em jogo.
O que é o skill-reach?
É uma ferramenta aberta pelo Google Cloud para pegar colisões de frontmatter antes de gastar com containers. Ela valida manifests, calcula a sobreposição de vocabulário com skills rivais e roda probes de roteamento em Claude Code, Google Antigravity e OpenAI Codex.
Por que não avaliar skills no laptop?
O laptop tem credenciais em cache, variáveis exportadas e histórico do bash que contaminam o baseline. A contenção de CPU também alterou resultados em testes internos do Google com agentes de code retrieval.
Como funciona a ablação pareada citada no post?
O Arm A roda o modelo base em sandbox limpo sem a skill. O Arm B roda o mesmo prompt e sandbox com a skill montada. Isso é repetido várias vezes (Pass@3), porque em um estudo de retrieval mais de um terço das tarefas variou entre execuções idênticas.
Fontes
- cloud.google.comfonte original
- Categoria
- CEVIU IA
- Publicado
- 03 de novembro de 2026
- Editoria
- CEVIU IA

