Torna agli aggiornamenti
New releaseAug 4, 2026

skill-scanner v2.0.13

Scanner di sicurezza per le abilità degli agenti

Condividi

Skill Scanner

License CPython 3.11–3.14 PyPI version CI Discord Cisco AI Defense AI Security Framework Ask DeepWiki

Uno scanner di sicurezza best-effort per AI Agent Skills che rileva prompt injection, esfiltrazione di dati e pattern di codice malevolo. Combina rilevamento basato su pattern (YAML + YARA-X), analisi AST e dataflow, un opzionale LLM-as-a-judge e un livello decisionale CEL limitato su fatti tipizzati dei rilevatori.

Importante: Questo scanner fornisce un rilevamento best-effort, non una copertura completa o esaustiva. Una scansione che non restituisce risultati non garantisce che una skill sia priva di tutte le minacce. Vedi Ambito e limitazioni di seguito.

Supporta i formati OpenAI Codex Skills e Cursor Agent Skills secondo la specifica Agent Skills. Con --lenient, scansiona anche formati non standard come Claude Code .claude/commands/*.md e repository di skill in markdown piatto.


Punti salienti

  • Rilevamento multi-motore - Analisi statica, dataflow comportamentale, analisi semantica LLM e scansione basata su cloud per una copertura a più livelli, best-effort
  • Decisioni CEL tipizzate - Lo scanner principale utilizza il runtime ufficiale cel-go v0.32.0 per correlare fatti limitati dopo il rilevamento deterministico e prima dell'analisi LLM opzionale
  • Preset misurati - Preset low-noise e quiet e limiti LLM, con recall, tasso di falsi positivi e F1 pubblicati per ciascuno (Impostazioni consigliate)
  • Pronto per CI/CD - Output SARIF per GitHub Code Scanning, workflow GitHub Actions riutilizzabile, codici di uscita per fallimenti di build
  • Hook pre-commit - Integrazione con il framework standard pre-commit per scansionare le skill prima di ogni commit
  • Estensibile - Architettura a plugin per analizzatori personalizzati

Unisciti al Cisco AI Discord per discutere, condividere feedback o connetterti con il team.


Ambito e limitazioni

Skill Scanner è uno strumento di rilevamento. Identifica pattern di rischio noti e probabili, ma non certifica la sicurezza.

Limitazioni principali:

  • Nessun risultato ≠ nessun rischio. Una scansione che restituisce "Nessun risultato" indica che non sono stati rilevati pattern di minaccia noti. Non garantisce che una skill sia sicura, benigna o priva di vulnerabilità.
  • La copertura è intrinsecamente incompleta. Lo scanner combina rilevamento basato su firme, analisi semantica basata su LLM, analisi del flusso di dati comportamentale, servizi cloud opzionali e pacchetti di regole configurabili. Sebbene questo approccio migliori la copertura, nessuno strumento automatizzato può rilevare ogni tecnica, specialmente gli attacchi nuovi o zero-day.
  • Possono verificarsi falsi positivi e falsi negativi. I preset, il giudice LLM e le soppressioni con ambito riducono il rumore, ma nessuna configurazione elimina tutte le classificazioni errate. Scegli una configurazione misurata da Recommended Settings e adatta la scan policy alla tua tolleranza al rischio.
  • La revisione umana rimane essenziale. La scansione automatizzata è una componente di una strategia di difesa in profondità. Le distribuzioni ad alto rischio o in produzione dovrebbero affiancare ai risultati dello scanner la revisione manuale del codice e/o la modellazione delle minacce.

Risultati misurati

Su skill held-out (split di test congelato di MaliciousSkillBench, 839 malevole e 545 innocue):

  • Solo le regole intercettano il 7,7% delle skill malevole a livello HIGH, con un tasso di falsi positivi del 4,0%.
  • Con il giudice LLM (Gemma 4 26B, balanced), il 66,7% raggiunge la revisione a MEDIUM+ (15,4% FPR), e il 33,7% viene bloccato a HIGH (6,4% FPR).

Ogni cifra, con il relativo corpus e metodo, è in Measured Results e sullo Space di valutazione.


Documentazione

Il sito web della documentazione è cisco-ai-defense.github.io/docs/skill-scanner. Le pagine di approfondimento si trovano in docs/.

Categorie