skill_github_tree

Hinweise:

Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins ALBERT | AI Agents. Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.
Wie Sie die KI-Tools in Ihren KI-Voreinstellungen verwenden, erfahren Sie hier: ALBERT | AI agents tools einrichten

Anzeigename: Returns the directory tree of a GitHub URL with skill folders marked

Technischer Name: agorum_ai_agents_library_basic_skill_github_tree

Was macht das Tool?

Dieses Tool gibt den Verzeichnisbaum unterhalb einer GitHub-URL zurück und markiert dabei alle Skill-Ordner (Ordner, die eine SKILL.md als direktes Kind enthalten) mit isSkill: true sowie einer fertigen skillUrl. Damit kann die KI vor einem Download herausfinden, welche Skills in einem Repository oder einem Teilbereich davon verfügbar sind.

Empfohlener Einsatzzweck

Durchsuchen eines GitHub-Repositories nach verfügbaren Skills
Vorbereitung für den Download: Die KI kann die passende URL für skill_download ermitteln
Übersicht über die Struktur eines Skill-Repositories

Funktionsbeschreibung

Parameter	Beschreibung
url (Pflicht)	GitHub-URL, deren Verzeichnisbaum zurückgegeben werden soll. Unterstützte Formate: `https://github.com/<owner>/<repo>` `https://github.com/<owner>/<repo>/tree/<branch>` `https://github.com/<owner>/<repo>/tree/<branch>/<pfad>`
depth (Optional)	Maximale Tiefe der Ordnerstruktur, die unterhalb der URL angezeigt wird. Standard: 4 Maximum: 10
githubToken (Optional, verschlüsselt)	GitHub Personal Access Token. Nur erforderlich für private Repositories oder bei ungewöhnlich hoher Nutzungsfrequenz. Wird verschlüsselt in der Tool-Konfiguration gespeichert.

Rückgabewerte

Feld	Beschreibung
owner	Besitzer des GitHub-Repositories.
repo	Name des Repositories.
branch	Branch-Name (Standard: `main`).
startPath	Startpfad innerhalb des Repositories (leer, wenn ab Root).
truncated	`true`, wenn GitHub die Antwort abgeschnitten hat (bei sehr großen Repositories mit über 100.000 Einträgen).
skillCount	Anzahl der gefundenen Skill-Ordner.
skills	Array mit den gefundenen Skills. Jeder Eintrag enthält `path`, `name` und `url` (direkte GitHub-URL zum Skill-Ordner).
tree	Hierarchische Baumstruktur des Repositories. Ordner mit einer `SKILL.md` sind mit `isSkill: true` und einer `skillUrl` markiert.

Technische Details

Das Tool verwendet die GitHub Trees API mit recursive=1, sodass die gesamte Repository-Struktur in einem einzigen API-Request geladen wird. Dadurch verbraucht jeder Aufruf genau einen GitHub-API-Request, unabhängig von der Größe des Repositories.

Hinweis: Bei sehr großen Repositories (mehr als 100.000 Einträge oder 7 MB Antwortgröße) kann GitHub die Antwort abschneiden. In diesem Fall ist das Feld truncated auf true gesetzt.

Tipps und Tricks

Tipps:

Verwenden Sie dieses Tool vor skill_download, um die verfügbaren Skills zu entdecken und die richtige URL zu ermitteln.
Wenn Sie nur einen Teilbereich eines Repositories durchsuchen möchten, geben Sie eine URL mit Pfad an (z. B. https://github.com/user/repo/tree/main/skills).
Die skillUrl in der Rückgabe kann direkt als url-Parameter für skill_download verwendet werden.