coroboros/skillward

Was macht skillward?

Prüft eine nicht vertrauenswürdige Agent-Fähigkeit – einen Ordner, ein Verzeichnis mit Fähigkeiten oder eine entfernte HTTPs-Git-Repository-URL –, indem es das vollständige deterministische Scanner-Ensemble offline ausführt und die Ergebnisse in einem einzigen Befund zusammenführt. Das CLI übernimmt die Erkennung; dieser Skill fügt den einen intelligenten Schritt hinzu: den Bericht lesen und erklären, was er bedeutet.

Installation

Das CLI ist die eigentliche Engine. Installiere es einmalig:

cargo binstall skillward     # vorkompilierte Binärdatei
brew install coroboros/tap/skillward
npx @coroboros/skillward     # Node-Toolchains

Dann lade das Scanner-Bundle herunter (einmalig, benötigt Docker):

skillward install

Wenn skillward nicht im PATH ist, stoppe und sage dem Benutzer, er solle es mit einem der obigen Befehle installieren – improvisiere keinen Scan. Ein selbstgestrickter Scan übersieht, was das Ensemble erfasst, und würde daher einen falschen Entwarnungs-Befund melden.

Verwendung

Führe skillward --help für die vollständige Oberfläche aus. Der Standard-Scan mit einem JSON-Bericht zur Triage:

skillward <ziel> --format json -o report.json

<ziel> ist ein Fähigkeiten-Ordner, ein Verzeichnis mit Fähigkeiten oder eine https://-Git-Repository-URL. Exit-Code 20 bedeutet, Funde haben die --fail-on-Schwelle (Standard: high) erreicht; 0 bedeutet sauber oder darunter.

Analyse

Nach dem Scan lies report.json und erstelle eine Triage – keine Neuauflage der Funde:

1. Beginne mit dem Urteil. PASS oder FAIL, die höchste Schwere und ob Funde korroboriert sind (mehrere Tools stimmen überein = hohe Vertrauenswürdigkeit).
2. Erkläre das tatsächliche Risiko der wichtigsten Funde in verständlicher Sprache – was ein Angreifer gewinnt, unter Nennung der spezifischen Datei und Regel (z. B. „exfiltriert AWS-Anmeldedaten bei jedem Aufruf – setup.sh:7, von skillspector und semgrep gemeldet“).
3. Weise auf etwaige tool_errors hin – ein Scanner, der nicht lief, bedeutet, das Bild ist unvollständig; sage das, statt auf Entwarnung zu schließen.
4. Fälle die Entscheidung: installieren, nicht installieren oder reparieren und dann erneut installieren. Für Reparaturen nenne die genaue Änderung.

Halte es kurz und entscheidungsorientiert. Die Funde sind im Bericht; das Urteil ist die eigentliche Arbeit.