nutstrut/skill-vetter-v2

O que skill-vetter-v2 faz?

Analisa e classifica habilidades de agentes quanto à segurança usando avaliação de risco local estruturada.

Visão Geral

Esta skill permite que um agente de IA avalie outras skills (definidas em formato SKILL.md ou como código) para identificar potenciais riscos de segurança. A avaliação é feita localmente, sem enviar dados para serviços externos, garantindo privacidade e baixa latência.

Como Funciona

1. A skill recebe o conteúdo de outra skill (por exemplo, o texto do SKILL.md e/ou arquivos de código).
2. Ela aplica um conjunto de verificações de risco predefinidas, como:
   • Acesso a variáveis de ambiente ou arquivos sensíveis
   • Execução remota de comandos ou scripts
   • Uso de bibliotecas ou APIs não confiáveis
   • Potencial para sobrecarga de recursos (CPU, memória, disco)
3. Com base nas verificações, a skill gera uma classificação de segurança: segura, baixo risco, risco médio ou alto risco.
4. Opcionalmente, ela retorna uma lista de preocupações detalhadas com níveis de severidade (moderado, alto, crítico).

Uso

Para usar esta skill, um agente pode invocá-la passando o caminho ou o conteúdo da skill a ser analisada:

# Exemplo de chamada (depende da plataforma)
skill-vetter-v2 analyze caminho/para/skill

Parâmetros

• target (obrigatório): Caminho ou conteúdo da skill a ser avaliada.
• format (opcional): Formato de saída (texto ou json). Padrão: texto.
• threshold (opcional): Nível mínimo de risco para reportar (baixo, médio, alto). Padrão: médio.

Exemplo de Saída (Formato Texto)

Classificação: ALTO RISCO
Preocupações:
- [CRÍTICO] A skill lê e modifica variáveis de ambiente (SHELL, PATH) e pode executar comandos arbitrários.
- [ALTO] A skill faz chamadas de rede para domínios não listados (exemplo: api.externa.com).
- [MODERADO] A skill não define limites de tempo de execução, podendo consumir recursos excessivos.

Plataformas Suportadas

• Agentes compatíveis com o formato SKILL.md (ex.: Claude Code, Cursor, Codex, etc.).
• Qualquer plataforma que permita que agentes leiam e interpretem arquivos markdown com definições de skills.

Notas de Segurança

• Esta skill NÃO envia dados para servidores externos; toda a análise é local.
• A classificação gerada é uma sugestão baseada em heurísticas; revisões humanas são recomendadas para decisões críticas.
• Atualize regularmente as regras de verificação para cobrir novos tipos de risco.

Licença

Esta skill é distribuída sob a licença MIT. Consulte o repositório original para mais detalhes.