navfa/skills-md-graph

Was macht skills-md-graph?

Ein Rust-CLI, das SKILL.md-Dateien von KI-Agenten parst, um Abhängigkeitsgraphen zu extrahieren und zu visualisieren, und so die Architektur und Verbindungen von Skills aufdeckt.

Übersicht

skills-md-graph ist ein Werkzeug, das die Abhängigkeiten zwischen Skills analysiert, die in SKILL.md-Dateien definiert sind. Es erstellt einen gerichteten Graphen, der zeigt, welche Skills voneinander abhängen.

Installation

# Mit Cargo installieren
cargo install skills-md-graph

# Oder direkt aus dem Repository bauen
git clone https://github.com/navfa/skills-md-graph.git
cd skills-md-graph
cargo build --release

Verwendung

# Abhängigkeitsgraphen für Skills im aktuellen Verzeichnis generieren
skills-md-graph ger

# In einem bestimmten Verzeichnis
skills-md-graph ger --input ./my-skills

# Als interaktives HTML ausgeben
skills-md-graph ger --format html

# Als JSON ausgeben (für maschinelle Verarbeitung)
skills-md-graph ger --format json

Ausgabeformate

• Text: Für die Konsole optimierte, lesbare Darstellung des Graphen.
• HTML: Interaktive Visualisierung mit D3.js, die Zoom und Tooltips unterstützt.
• JSON: Maschinenlesbare Repräsentation für die Integration in andere Tools.

Nützliche Befehle

set-diff

Zeigt den Unterschied zwischen zwei Skill-Sets an. Nützlich, um zu sehen, welche Skills in einem Verzeichnis hinzugefügt oder entfernt wurden.

skills-md-graph set-diff --old ./verzeichnis-alt --new ./verzeichnis-neu

diff-tables

Vergleicht die Abhängigkeitstabellen zweier Skill-Sets und zeigt Änderungen an.

skills-md-graph diff-tables --old ./verzeichnis-alt --new ./verzeichnis-neu

Funktionsweise

Das Tool durchsucht das angegebene Verzeichnis rekursiv nach Dateien mit dem Namen SKILL.md. Aus diesen Dateien extrahiert es die YAML-Frontmatter-Felder skillDependencies und dependencyPaths. Die extrahierten Abhängigkeiten werden in einen gerichteten Graphen umgewandelt, der dann je nach Format ausgegeben wird.

Konfiguration

Das Tool kann über Umgebungsvariablen konfiguriert werden:

• SKILLS_MD_GRAPH_DIR – Standardverzeichnis für Skill-Dateien
• SKILLS_MD_GRAPH_OUTPUT – Standardausgabeformat (text, html, json)

Beitragen

Pull-Requests sind willkommen! Bitte stellen Sie sicher, dass Ihr Code den Rust-Standards entspricht und Tests erfolgreich durchlaufen:

cargo test
cargo clippy

Lizenz

MIT