SkillSpector: scanner de segurança para skills de agentes

Para quem é

SkillSpector é um scanner de segurança para skills de agentes de IA oferecido pela NVIDIA no GitHub; o posicionamento oficial é detectar vulnerabilidades, padrões maliciosos e riscos de segurança antes de instalar um skill. É adequado para:

• Usuários prestes a instalar um skill de agente de terceiros: por exemplo, um zip de skill baixado da comunidade ou um repositório compartilhado por outra pessoa, e que querem confirmar que não há padrões maliciosos nem vulnerabilidades evidentes antes de colocar no agente local.
• Mantenedores que precisam auditar a procedência de skills: as entradas de escaneamento aceitam repositórios Git, URLs, arquivos zip, diretórios ou arquivos únicos, cobrindo diferentes formas de distribuição.
• Pessoas que já têm uv instalado, cujo agente suporta MCP e que querem usar o escaneamento como uma ferramenta que o agente possa chamar diretamente.

Casos em que não serve ou exige atenção:

• Ele só faz verificações estáticas: a documentação oficial afirma que nunca executa o skill escaneado; o comportamento real do skill em execução fica fora do escopo, e passar no escaneamento não significa que seja seguro rodar.
• Ele mira o próprio pacote do skill e não substitui outros trabalhos de segurança, como permissões do sistema ou a cadeia de suprimentos de dependências.
• Sem uv, a página oficial não apresenta outro método de instalação; a disponibilidade não está confirmada.
• Os critérios de julgamento do escaneamento e a cobertura das regras não são descritos oficialmente; não confirmado.

Primeira tentativa em 3 minutos

O caminho mais direto com suporte oficial: primeiro instale com uv a partir do repositório do GitHub como ferramenta de linha de comando e depois chame um escaneamento de um agente local com suporte a MCP.

Pré-requisitos: uv instalado na máquina; o agente deve suportar MCP.

Passo 1, execute o comando oficial de instalação no terminal:

uv tool install git+https://github.com/NVIDIA/skillspector.git

Atenção ao efeito colateral: segundo a documentação oficial, o projeto baixará e instalará também outros softwares de código aberto de terceiros; confirme que aceita isso antes de executar.

Passo 2, conecte o escaneamento ao seu agente local. Segundo a documentação oficial, ele roda como servidor MCP, de forma que agentes locais com suporte a MCP, como Claude Code, Codex CLI e Gemini CLI, podem chamar o escaneamento como ferramenta. A forma concreta de registrar o servidor MCP (local do arquivo de configuração, comando de inicialização e argumentos) não está descrita na página oficial; este artigo não especula: siga as instruções do repositório.

Passo 3, faça um escaneamento de baixo risco. Peça ao agente, em linguagem natural, que escaneie o diretório ou o arquivo zip onde está um skill, por exemplo: “Escaneie este diretório de skill e verifique se há padrões maliciosos e riscos de segurança.” É uma operação de análise; segundo a documentação oficial, o skill escaneado não é executado.

Sinais de sucesso: o comando do passo 1 termina sem erros; depois de conectar, o agente consegue iniciar escaneamentos como ferramenta e receber resultados. O formato e os campos exatos do relatório de escaneamento não são descritos oficialmente; não confirmado, guie-se pelo retorno real.

Casos de uso

Caso 1: verificação de segurança antes de instalar um skill de terceiros. Você recebe da comunidade um zip de um skill e quer instalá-lo no seu agente. Instrua um agente com suporte a MCP: “Use a ferramenta de escaneamento para examinar este arquivo zip e relatar padrões maliciosos e riscos de segurança.” Ele chamará o fluxo de escaneamento sobre esse zip (um tipo de entrada com suporte oficial) e devolverá os resultados da análise estática. A partir disso você decide se continua a instalação; como a verificação não executa nada, o comportamento real do skill ainda merece sua atenção.

Caso 2: auditar um repositório de skills que você mantém. Você mantém um skill em um repositório Git e teme que alguma alteração tenha introduzido um padrão perigoso. Peça ao agente para escanear esse repositório Git ou a URL dele e veja os problemas encontrados na versão atual; a entrada é diretamente o repositório ou a URL, sem empacotamento manual, o que combina com uma checagem após mesclar alterações ou em intervalos regulares.

Limites de uso

• Acesso a arquivos e comandos: o escaneamento é análise estática e a documentação oficial afirma que nunca executa o skill escaneado; se ele grava arquivos temporários ou acessa a rede não está documentado; não confirmado.
• Efeito colateral da instalação: o comando de instalação baixa e instala também softwares de código aberto de terceiros; é o ponto de confirmação mais claro antes de executar.
• Pré-requisitos de ambiente e cliente: é preciso ter uv; a chamada via MCP exige um agente local com suporte a MCP, com Claude Code, Codex CLI e Gemini CLI citados oficialmente. Não está confirmado se outros agentes funcionam: não assuma que se limita a esses três nem que todos sirvam.
• Uso dos resultados: os resultados do escaneamento apoiam seu julgamento; instalar ou não e como proceder continua sendo decisão sua. Não está documentado que possam servir como conclusão direta de uma auditoria de segurança; não confirmado.
• Informações ainda não confirmadas: o formato do relatório de escaneamento, os sistemas operacionais com suporte e a necessidade de rede não aparecem na página oficial; antes de usar, siga a documentação mais recente do repositório.