Scanner de segurança estático para pacotes de skills de agentes de IA. Detecta arquivos SKILL.md maliciosos e scripts empacotados antes que eles sejam executados.
Se o SkillsGuard protege o seu pipeline, considere apoiar a pesquisa contínua e novas regras de deteção.
Carteira de Doações ETH
0x11282eE5726B3370c8B480e321b3B2aA13686582
Leia o código QR ou copie o endereço da carteira acima.
Scanner de segurança estático para pacotes de skills de agentes de IA. Deteta ficheiros SKILL.md maliciosos e scripts incluídos antes de serem executados.
# Scan any SKILL.md with a single curl — no account, no key
curl -s --data-binary @SKILL.md \
https://skillsguard.apiskillsguard.workers.dev/scan | jq .
Nota: O SkillsGuard não está publicado atualmente no registro npm. Instale clonando e compilando a partir do código-fonte.
# 1. Clone, install, build, and link
git clone https://github.com/Teycir/SkillsGuard.git
cd SkillsGuard
npm install
npm run build
npm link
# 2. Scan any skill directory or file
skillsguard /path/to/skill
É isso. O SkillsGuard imprime os achados com código de cores no terminal (ou --json para CI).
Código de saída 0 = limpo · 1 = achados · 2 = erro de uso.
Quer que o Claude chame o scanner automaticamente dentro do seu fluxo de trabalho do agente? Consulte Local Workflow → Path B para a configuração completa de skill + MCP.
flowchart TD
A([Folder, file, or Git diff target]) --> B[Load config\nskillsguard.config.json]
B --> C[File discovery\nFilter JS, PY, PS1, Docker, Ruby...]
C --> D{For each file}
D --> E[Raw text scan\nApply 100+ rules]
D --> F[decode.ts\nExtract encoded blobs]
F --> G[Recursive decode\nbase64, hex, URL]
G --> H[Scan decoded content]
E & H --> I{Findings?}
I -->|no| J([✅ Clean — exit 0])
I -->|yes| K[Deduplicate findings]
K --> L[Compute Risk Score\n0 - 100]
L --> M{Output mode}
M -->|CLI| N[ANSI colored report]
M -->|--json| O[JSON output]
M -->|--sarif| P[SARIF output]
M -->|MCP| Q[MCP response]
N & O & P & Q --> R{Risk > max-risk?}
R -->|yes| S([❌ Exit 1])
R -->|no| J
style A fill:#0d1117,stroke:#00ff88,color:#c3f5dc
style J fill:#0d1117,stroke:#00ff88,color:#00ff88
style S fill:#0d1117,stroke:#ff4444,color:#ff8888
style G fill:#0d1117,stroke:#f0a500,color:#f0c060
style K fill:#0d1117,stroke:#00ff88,color:#c3f5dc
Insight principal: O SkillsGuard decodifica payloads ofuscados antes da verificação, para que um reverse shell encapsulado em base64 não passe despercebido. Cada descoberta é deduplicada — cada regra é acionada no máximo uma vez por arquivo por linha.
O espaço de segurança de skills de agentes se encheu rapidamente em 2026 — NVIDIA, Cisco, Snyk e Mondoo lançaram scanners para exatamente esse problema. Vale a pena conhecer o campo antes de escolher uma ferramenta, incluindo esta.
| Ferramenta | Apoio | Requer conta/token | Requer chamada de LLM para a verificação principal | Abordagem de detecção | Extra notável |
|---|---|---|---|---|---|
| SkillsGuard | Independente, MIT | Não | Não | Regex estático, decodificação primeiro (desembrulho recursivo de base64/hex/URL/Unicode) | Hook de pré-commit + modo git-diff; API curl gratuita |
| NVIDIA SkillSpector | NVIDIA, Apache 2.0 | Não | Não (opcional, para estágio semântico) | Estático + passagem semântica opcional por LLM | Consulta ao vivo de CVE de dependências via OSV.dev |
| Cisco AI Defense Skill Scanner | Cisco | Não | Não (opcional, para estágio semântico) | Multi-motor: estático + dataflow comportamental + semântica por LLM + nuvem | Workflow do GitHub Actions integrado |
| Snyk Agent Scan (antigo mcp-scan) | Snyk, comercial | Sim — SNYK_TOKEN obrigatório | Sim — regras determinísticas + juízes LLM combinados | Descoberta automática em Claude/Cursor/Windsurf/Gemini CLI + servidores MCP | Alimenta a verificação de skills no momento da instalação da Vercel |
| SkillScan | Independente | Não | Apenas para o modo predict (opcional) | Motor de regras YAML + dry-run comportamental opcional por LLM + sandbox Docker opcional | Detecção de ativação temporal/atrasada via role-play de LLM |
| Mondoo Skill Check | Mondoo, comercial | Não (nível gratuito, não comercial) | Incerto a partir da documentação pública | Estático, mapeado para o OWASP LLM Top 10 | Dashboard hospedado + API REST |