
SkillSpector v2.11.1
Scanner di sicurezza per le skill degli agenti AI. Rileva vulnerabilità, pattern dannosi, rischi di sicurezza, prompt injection, esfiltrazione di dati e rischi della supply chain nelle skill di Claude Code, Codex e MCP prima di installarle.
SkillSpector
Scanner di sicurezza per skill di agenti AI. Rileva vulnerabilità, pattern malevoli e rischi di sicurezza prima di installare le skill degli agenti.
Panoramica
Le skill degli agenti AI (utilizzate da Claude Code, Codex CLI, Gemini CLI, ecc.) vengono eseguite con fiducia implicita e con una verifica minima. Nel sottoinsieme di 31.132 skill analizzate del dataset di ricerca, il 26,1% delle skill contiene vulnerabilità e il 5,2% mostra una probabile intenzione malevola.
SkillSpector ti aiuta a rispondere alla domanda: "Questa skill è sicura da installare?"
SkillSpector fa parte della pipeline NVIDIA Verified Skills, che analizza, valuta e firma le skill degli agenti prima della pubblicazione. Le skill che superano i controlli vengono pubblicate nel catalogo delle skill NVIDIA.
Documentazione
- Scansiona le skill degli agenti prima dell'installazione — Guida ospitata: quando eseguire la scansione, come leggere un report e come bloccare le installazioni.
- Guida allo sviluppo — Architettura, struttura dei pacchetti e come estendere la pipeline di analisi.
- Politica di sicurezza — Segnala privatamente a NVIDIA PSIRT le vulnerabilità sospette.
- Limiti delle risorse di analisi — Limiti fail-closed per bundle, parser, artefatti annidati, ledger e finding.
- Estensione Pi — Installa SkillSpector come strumento Pi per scansionare le skill dall'interno delle sessioni degli agenti.
- Estensione OpenCode — Installa SkillSpector come strumento OpenCode e comando
/skillspectorper scansionare le skill dall'interno delle sessioni degli agenti. - Guida di base all'analizzatore LLM — Come costruire nodi di analisi basati su LLM sopra
LLMAnalyzerBase. - Reindirizzamento della sorgente delle dipendenze — Come i finding SC10 segnalano una skill che modifica la provenienza dei download dei propri pacchetti.
- Ricerche di vulnerabilità in tempo reale (SC4) — Come SC4 verifica le dipendenze rispetto a OSV.dev.
- Scansione dei dataset di valutazione — Quali file dei dataset di valutazione vengono ignorati dagli analizzatori di pattern statici.
- Analisi del privilegio minimo MCP (LP1–LP4) e Rilevamento dell'avvelenamento degli strumenti MCP (TP1–TP4) — Note di progettazione per gli analizzatori MCP.
Funzionalità
- Input multi-formato: scansiona repository Git, URL, file zip, directory o singoli file
- 71 pattern di vulnerabilità in 17 categorie: prompt injection, esfiltrazione di dati, escalation di privilegi, supply chain, agenzia eccessiva, gestione dell'output, fuga del system prompt, avvelenamento della memoria, uso improprio degli strumenti, agente canaglia, anti-rifiuto, abuso dei trigger, codice pericoloso (AST), taint tracking, firme YARA, privilegio minimo MCP e avvelenamento degli strumenti MCP
- Analisi in due fasi: analisi statica rapida + valutazione semantica LLM opzionale
- Ricerche di vulnerabilità in tempo reale: SC4 interroga OSV.dev per dati CVE in tempo reale con fallback offline automatico
- Molteplici formati di output: report per terminale, JSON, Markdown e SARIF
- Punteggio di rischio: punteggio da 0 a 100 con etichette di gravità e raccomandazioni chiare
- Baseline / soppressione dei falsi positivi: accetta finding noti tramite una baseline basata su regole glob o fingerprint, così le nuove scansioni mostrano solo i problemi nuovi (documentazione)
Avvio rapido
Installazione
Avviso sul software open source: Questo progetto scaricherà e installerà ulteriori progetti software open source di terze parti. Consulta i termini di licenza di questi progetti open source prima dell'uso.
Usa Python 3.12 o 3.13 per l'installazione con wheel YARA precompilate sulle piattaforme supportate. Gli esempi seguenti selezionano esplicitamente la 3.13; consulta le
note sull'installazione di Python per gli interpreti più recenti.
Per le installazioni da sorgente, crea e attiva prima un ambiente virtuale (tutti i target make
presuppongono che il venv sia attivo). Usa uv o pip; il Makefile usa uv
se disponibile, altrimenti pip.
Installazione rapida con uv (solo CLI):
uv tool install --python 3.13 git+https://github.com/NVIDIA/skillspector.git
# Update later: uv tool update skillspector
Se hai intenzione di eseguire skillspector mcp, installa l'extra MCP al momento dell'installazione:
uv tool install --python 3.13 'skillspector[mcp] @ git+https://github.com/NVIDIA/skillspector.git'
Dall'origine:
# Clone the repository
git clone https://github.com/NVIDIA/skillspector.git
cd skillspector
# Create and activate virtual environment
uv venv --python 3.13 .venv && source .venv/bin/activate
# or: python3.13 -m venv .venv && source .venv/bin/activate
# Install for production use
make install
Per contribuire, segui la Configurazione di sviluppo per un interprete Python supportato e le dipendenze di sviluppo.
Note sull'installazione di Python
Il pacchetto dichiara Python >=3.12,<3.16 in pyproject.toml.
Tale intervallo non garantisce wheel precompilate per ogni dipendenza e piattaforma.
yara-python 4.5.4 su PyPI
fornisce wheel per CPython 3.12/3.13, ma nessuna wheel per CPython 3.14/3.15. Installarlo
su questi interpreti più recenti richiede una compilazione nativa dai sorgenti con una toolchain C
e gli header di sviluppo di Python. Tali compilazioni possono fallire con gli header di OpenSSL 4;
issue #1008 tiene traccia di questo
problema di installazione e della disponibilità delle wheel upstream.
Se l'installazione fallisce durante la compilazione di YARA, seleziona esplicitamente Python 3.12 o 3.13
usando i comandi sopra. Per una nuova installazione solo CLI con pipx, installa prima
Python 3.13 e rendi python3.13 disponibile nel PATH, poi esegui:
pipx install --python python3.13 git+https://github.com/NVIDIA/skillspector.git
L'aggiornamento upstream della build della wheel è separato dalla pubblicazione di una nuova release su PyPI. Controlla i file pubblicati prima di scegliere un interprete più recente; potrebbe essere comunque necessaria una build dai sorgenti.