O Google Cloud Agent Registry passou a verificar automaticamente o arquivo SKILL.md, scripts e ativos de uma skill contra riscos como credenciais expostas, exfiltração de dados e prompt injection. A função foi anunciada em 6 de novembro de 2026, junto com a disponibilidade geral de skills independentes. Para empresas, o fluxo seguro é registrar cada pacote como uma revisão imutável, manter a verificação bloqueante por padrão, revisar manualmente os achados e só promover uma revisão aprovada para uso dos agentes.
Entenda o que mudou no Agent Registry
Skills independentes chegaram à disponibilidade geral no Agent Registry. A empresa pode registrar uma skill, criar revisões imutáveis, pesquisar o catálogo e verificar o publicador. A mesma atualização adicionou verificação de segurança, políticas organizacionais e permissões específicas para administrar esses pacotes.
O registro não transforma uma skill em código confiável. Ele cria uma fonte controlada para saber qual pacote existe, quem publicou, qual revisão está ativa e quais verificações foram executadas. Essa rastreabilidade reduz cópias soltas em repositórios, chats e computadores de usuários.
Prepare o pacote antes de enviar
Mantenha no pacote apenas instruções, scripts e ativos necessários. Remova chaves, tokens, arquivos de ambiente, dados de clientes e exemplos com informação real. Descreva finalidade, entradas, saídas, ferramentas permitidas e situações em que a skill deve parar ou pedir aprovação.
Associe cada revisão a um repositório, responsável e processo de mudança. Como a revisão é imutável, uma correção deve gerar um novo pacote. Preserve o vínculo entre código revisado, arquivo ZIP enviado e identificador retornado pelo registro para impedir que um arquivo diferente seja promovido por engano.
- Responsável técnico e proprietário de negócio
- Origem do código e revisão aprovada
- Permissões, rede e dados necessários
- Testes funcionais e casos adversariais
- Plano de reversão para a revisão anterior
Escolha entre modo bloqueante e auditoria
A política padrão é Enabled Blocking. Nesse modo, o Agent Registry verifica a revisão enviada, impede o download de pacotes com achados e não permite promover uma revisão com achados ou com análise pendente como padrão. É a escolha adequada para o catálogo usado em produção.
O modo Enabled Nonblocking mantém os achados sem bloquear o pacote e pode ser útil em um projeto de teste isolado. Disabled ignora a verificação. Exceções devem ter prazo, justificativa, proprietário e ambiente limitado. Desativar o scanner para cumprir um prazo apenas transfere o risco para o agente que executará o pacote.
Revise cada Finding antes de corrigir
Os achados indicam severidade, classe, arquivo, linha aproximada e detalhe. As classes documentadas incluem vulnerabilidade e segredo em texto simples. A equipe deve abrir o arquivo apontado, confirmar o comportamento e verificar se o risco é alcançável com as permissões reais do agente.
A análise usa modelos de linguagem e pode gerar falso positivo, falso negativo ou uma explicação imprecisa. Não altere código apenas para silenciar o resultado. Confirme a causa, corrija a fonte local, crie uma nova revisão e verifique se o novo scan terminou sem achados antes de mudar a revisão padrão.
Aplique menor privilégio e política organizacional
Separe quem registra skills, quem visualiza revisões, quem consulta achados e quem altera políticas. A documentação lista funções distintas de IAM para essas tarefas. Use contas de serviço dedicadas e evite conceder administração do registro apenas para permitir o envio de um pacote.
Organizações podem criar uma restrição personalizada para impedir que projetos desativem a verificação ou para exigir o modo bloqueante. Teste a política em uma pasta ou projeto pequeno, confira exceções por tag e registre quem pode aprová-las. Uma regra global mal configurada pode bloquear publicação legítima ou deixar ambientes importantes fora do controle.
Considere limites e revisões antigas
Com o scan ativo, o pacote descompactado pode ter até 10 MB e cada arquivo até 1 MB. Pacotes maiores podem falhar ou ficar com estado de formato não suportado. Divida materiais extensos, remova dependências desnecessárias e mantenha arquivos grandes em uma fonte externa com acesso controlado.
Alterar a política de scan não verifica retroativamente revisões já existentes. Para analisar um conteúdo enviado quando a função estava desativada, crie uma nova revisão. Faça um inventário inicial e impeça que uma revisão antiga sem verificação continue como padrão apenas por já estar funcionando.
Não trate o scan como garantia completa
A verificação do pacote não substitui análise de dependências, testes de execução, sandbox, controle de saída de rede, gestão de segredos e monitoramento. Uma instrução aparentemente segura pode produzir dano quando recebe dados maliciosos ou usa uma ferramenta com permissão excessiva.
Teste a skill com arquivos hostis, instruções conflitantes, falhas de API e tentativas de acessar recursos proibidos. Registre revisão, agente, usuário, ferramentas e resultado. A promoção só deve ocorrer quando segurança, responsável pelo processo e operação conseguem explicar o comportamento e interrompê-lo se necessário.
Para levar daqui
O scan do Agent Registry cria um controle útil para skills, mas o pacote só deve chegar aos agentes depois de revisão humana, menor privilégio, testes de execução e uma revisão imutável aprovada.
