Escáner de seguridad estático para paquetes de habilidades de agentes de IA. Detecta archivos SKILL.md maliciosos y scripts empaquetados antes de que se ejecuten.
Si SkillsGuard protege tu pipeline, considera apoyar la investigación continua y las nuevas reglas de detección.
Monedero de Donación ETH
0x11282eE5726B3370c8B480e321b3B2aA13686582
Escanea el código QR o copia la dirección del monedero de arriba.
Escáner de seguridad estático para paquetes de skills de agentes de IA. Detecta archivos SKILL.md maliciosos y scripts incluidos antes de que se ejecuten.
# 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: SkillsGuard no está publicado actualmente en el registro de npm. Instálalo clonando y compilando desde el código fuente.
# 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
Eso es todo. SkillsGuard imprime hallazgos codificados por colores en la terminal (o --json para CI).
Código de salida 0 = limpio · 1 = hallazgos · 2 = error de uso.
¿Quieres que Claude llame al escáner automáticamente dentro del flujo de trabajo de tu agente? Consulta Flujo de trabajo local → Ruta B para la configuración 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
Idea clave: SkillsGuard decodifica las cargas útiles ofuscadas antes de escanear, de modo que un reverse shell envuelto en base64 no puede colarse. Cada hallazgo se deduplica: cada regla se activa como máximo una vez por archivo por línea.
El espacio de la seguridad de skills para agentes se llenó rápido en 2026: NVIDIA, Cisco, Snyk y Mondoo han lanzado escáneres para este mismo problema. Vale la pena conocer el campo antes de elegir una herramienta, incluida esta.
| Herramienta | Respaldo | Requiere cuenta/token | Requiere llamada a LLM para el escaneo principal | Enfoque de detección | Extra destacable |
|---|---|---|---|---|---|
| SkillsGuard | Independiente, MIT | No | No | Regex estático, decodificación primero (desenvolvimiento recursivo de base64/hex/URL/Unicode) | Hook de pre-commit + modo git-diff; API curl gratuita |
| NVIDIA SkillSpector | NVIDIA, Apache 2.0 | No | No (opcional, para la etapa semántica) | Estático + pasada semántica opcional con LLM | Búsqueda en vivo de CVE de dependencias en OSV.dev |
| Cisco AI Defense Skill Scanner | Cisco | No | No (opcional, para la etapa semántica) | Multi-motor: estático + flujo de datos conductual + semántica con LLM + nube | Flujo de trabajo de GitHub Actions integrado |
| Snyk Agent Scan (antes mcp-scan) | Snyk, comercial | Sí — se requiere SNYK_TOKEN | Sí — reglas deterministas + jueces LLM combinados | Autodescubrimiento en Claude/Cursor/Windsurf/Gemini CLI + servidores MCP | Impulsa el escaneo de skills en la instalación de Vercel |
| SkillScan | Independiente | No | Solo para el modo predict (opcional) | Motor de reglas YAML + simulación conductual opcional con LLM + sandbox Docker opcional | Detección de activación temporal/retardada mediante role-play con LLM |
| Mondoo Skill Check | Mondoo, comercial | No (nivel gratuito, no comercial) | No está claro según la documentación pública | Estático, se asigna al OWASP LLM Top 10 | Panel alojado + API REST |