Repolode
cisco-ai-defense

cisco-ai-defense/skill-scanner

Un escáner de seguridad de mejor esfuerzo para AI Agent Skills que detecta prompt injection, exfiltración de datos y patrones de código malicioso.

Estrellas
2,701
Forks
342
Issues abiertos
2
Último commit
ayer

¿Qué es?

Skill Scanner revisa las habilidades de agentes de IA para detectar contenido riesgoso antes de instalarlas o compartirlas. Combina detección basada en patrones con reglas YAML y YARA-X, análisis AST y de flujo de datos del código Python, y un evaluador LLM opcional que revisa los hallazgos desde una perspectiva semántica. Los resultados se pueden generar en JSON, Markdown, SARIF o como informe HTML interactivo.

El escáner está diseñado para los formatos de habilidades de agentes de Codex y Cursor. Con una opción de modo permisivo, también admite archivos de comandos de Claude Code y repositorios de habilidades en Markdown sin estructura de carpetas. Puede analizar una sola habilidad, un directorio de habilidades o un repositorio de GitHub, y ofrece una CLI, un SDK de Python, una API REST y un hook de pre-commit. Los ajustes preestablecidos de políticas, como balanced, low-noise y quiet, controlan cuántos hallazgos se envían a revisión.

La detección es explícitamente de mejor esfuerzo: que un análisis no encuentre nada no certifica que una habilidad sea segura, y el proyecto recomienda complementar los resultados con una revisión manual antes de usarla en producción.

Funciones clave

  • 01Combina reglas de patrones en YAML y YARA-X con análisis AST y de flujo de datos.
  • 02Evaluador LLM opcional para la revisión semántica de hallazgos, con varias opciones de proveedor.
  • 03Genera informes en JSON, Markdown, SARIF y HTML interactivo.
  • 04Ofrece un workflow reutilizable de GitHub Actions y un hook de pre-commit.
  • 05Admite ajustes preestablecidos de políticas y políticas YAML personalizadas para ajustar el nivel de ruido.

Casos de uso

  • Evaluar habilidades de agentes de terceros antes de instalarlas en un asistente de programación.
  • Controlar los cambios en las habilidades desde CI y mostrar los resultados SARIF en GitHub Code Scanning.
  • Analizar el repositorio de habilidades de un equipo en cada commit mediante pre-commit.
  • Auditar en bloque un directorio de habilidades y comprobar los solapamientos entre ellas.

Inicio rápido

  1. 1

    Instala el escáner con uv

    uv pip install cisco-ai-skill-scanner
  2. 2

    Configura la clave de API de LLM judge

    export SKILL_SCANNER_LLM_API_KEY="your_api_key"
  3. 3

    Analiza un skill con LLM judge y el preset balanced

    skill-scanner scan /path/to/skill --use-llm --policy balanced --fail-on-severity high

Antes de usarlo

  • La detección es solo de mejor esfuerzo; que un análisis no encuentre nada no garantiza que un skill sea seguro.
  • Las configuraciones recomendadas necesitan una clave de API de LLM judge, ya que las reglas por sí solas solo detectan alrededor del 8 % de los skills maliciosos del conjunto de prueba reservado.
  • En los metadatos, la licencia figura como NOASSERTION, por lo que debes comprobar sus términos antes de usarlo.

En colecciones

Temas

Preguntas frecuentes

¿Qué es skill-scanner?
Un escáner de seguridad de mejor esfuerzo para AI Agent Skills que detecta prompt injection, exfiltración de datos y patrones de código malicioso. Skill Scanner revisa las habilidades de agentes de IA para detectar contenido riesgoso antes de instalarlas o compartirlas. Combina detección basada en patrones con reglas YAML y YARA-X, análisis AST y de flujo de datos del código Python, y un evaluador LLM opcional que revisa los hallazgos desde una perspectiva semántica. Los resultados se pueden generar en JSON, Markdown, SARIF o como informe HTML interactivo.
¿skill-scanner es gratuito? ¿Qué licencia tiene?
skill-scanner es open source bajo la licencia Other. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿skill-scanner sigue mantenido?
Mantenimiento activo. El último commit de skill-scanner fue el 6 nov 2026.
¿Para qué puedo usar skill-scanner?
Evaluar habilidades de agentes de terceros antes de instalarlas en un asistente de programación. Controlar los cambios en las habilidades desde CI y mostrar los resultados SARIF en GitHub Code Scanning. Analizar el repositorio de habilidades de un equipo en cada commit mediante pre-commit. Auditar en bloque un directorio de habilidades y comprobar los solapamientos entre ellas.
¿Cómo se instala skill-scanner?
Instala el escáner con uv: uv pip install cisco-ai-skill-scanner Configura la clave de API de LLM judge: export SKILL_SCANNER_LLM_API_KEY="your_api_key" Analiza un skill con LLM judge y el preset balanced: skill-scanner scan /path/to/skill --use-llm --policy balanced --fail-on-severity high
¿Dónde consigo skill-scanner?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/cisco-ai-defense/skill-scanner

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados