Was macht SkillScan?
Sicherheitsscanner für SKILL.md-Dateien von KI-Agenten. Statische Analyse, LLM-Verhaltensvorhersage und Docker-Sandbox-Ausführung.
Überblick
NMitchem/SkillScan führt eine gründliche Sicherheitsprüfung von SKILL.md-Dateien durch, die KI-Agenten-Fähigkeiten definieren. Er kombiniert mehrere Analyseebenen, um potenzielle Sicherheitslücken zu identifizieren:
- Statische Analyse: Untersucht den Code und die Konfiguration in der SKILL.md auf bekannte Sicherheitsmuster und Schwachstellen.
- LLM-Verhaltensvorhersage: Simuliert, wie ein KI-Agent die beschriebenen Fähigkeiten interpretieren und ausführen würde.
- Docker-Sandbox-Ausführung: Führt den Skill in einer isolierten Docker-Umgebung aus, um dynamisches Verhalten zu beobachten.
Funktionen
- Umfassende Sicherheitsprüfung: Erkennt unsichere API-Nutzung, potenzielle Datenlecks und verdächtige Befehle.
- Plattformübergreifende Kompatibilität: Funktioniert mit SKILL.md-Dateien, die für Claude Code, Cursor, Codex und andere Agentenplattformen erstellt wurden.
- Detaillierte Berichte: Generiert einen vollständigen Sicherheitsbericht mit Prioritätsstufen und Handlungsempfehlungen.
- Automatisierte Workflows: Kann in CI/CD-Pipelines integriert werden, um Sicherheitsprüfungen automatisch durchzuführen.
Schnellstart
# Installation
git clone https://github.com/NMitchem/SkillScan.git
cd SkillScan
pip install -r requirements.txt
# Einfache Verwendung
python scan.py --file pfad/zu/deiner/SKILL.md
# Mit Docker-Sandbox
python scan.py --file pfad/zu/deiner/SKILL.md --sandbox docker
Konfiguration
Der Scanner kann über Umgebungsvariablen konfiguriert werden:
| Variable | Beschreibung | Standardwert |
|---|---|---|
SKILL_SCAN_LEVEL | Scan-Tiefe (basic, standard, advanced) | standard |
DOCKER_IMAGE | Basis-Docker-Image für Sandbox | ubuntu:latest |
LLM_MODEL | LLM-Modell für Verhaltensvorhersage | gpt-4 |
Ausgabe
Normalerweise erzeugt SkillScan einen Bericht im JSON-Format:
{
"scan_id": "abc-123",
"timestamp": "2024-01-01T00:00:00Z",
"overall_risk": "medium",
"findings": [
{
"severity": "high",
"description": "Unsicherer API-Endpunkt erkannt",
"location": "Zeile 42"
}
]
}
Integration in CI/CD
Fügen Sie SkillScan zu Ihrem GitHub Actions-Workflow hinzu:
name: Security Scan
on: [push, pull_request]
jobs:
scan:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Run SkillScan
uses: NMitchem/SkillScan@v1
with:
file: path/to/SKILL.md
Lizenz
MIT