skill_download

Anzeigename: Downloads a Claude skill from GitHub into agorum core

Technischer Name: agorum_ai_agents_library_basic_skill_download

Was macht das Tool?

Dieses Tool lädt einen Skill von einer GitHub-URL in einen agorum core Ordner herunter. Die URL muss direkt auf einen Skill-Ordner zeigen, d. h. auf einen Ordner, der eine SKILL.md-Datei als direktes Kind enthält. Alle Dateien und Unterordner des Skills werden in den Zielordner heruntergeladen.

Empfohlener Einsatzzweck

• Herunterladen von Skills aus öffentlichen oder privaten GitHub-Repositories
• Aktualisieren bestehender Skills durch erneuten Download mit Überschreiben
• Aufbau einer lokalen Skill-Bibliothek in agorum core

Funktionsbeschreibung

Parameter	Beschreibung
url (Pflicht)	GitHub-URL, die direkt auf einen Skill-Ordner zeigt. Der Ordner muss eine SKILL.md als direktes Kind enthalten. Unterstützte Formate: https://github.com/<owner>/<repo>/tree/<branch>/<pfad-zum-skill> https://github.com/<owner>/<repo>/tree/<branch> (nur wenn SKILL.md im Repository-Root liegt) https://github.com/<owner>/<repo> (Standard-Branch main, nur wenn SKILL.md im Root liegt) Wenn die URL nicht direkt auf einen Skill-Ordner zeigt, gibt das Tool einen Fehler zurück. Verwenden Sie in diesem Fall zuerst skill_github_tree, um die verfügbaren Skills zu ermitteln.
targetId (Pflicht)	Zielordner in agorum core. Der Skill wird als Unterordner dieses Zielordners erstellt. Format: Objekt-ID eines agorum core Ordners.
basename (Optional)	Überschreibt den Namen des Skill-Ordners. Standardmäßig wird das letzte Pfadsegment der URL als Ordnername verwendet.
overwrite (Optional)	Wenn true, wird ein bestehender Skill-Ordner mit demselben Namen ersetzt. Der bestehende Ordner muss selbst ein Skill-Ordner sein (eine SKILL.md enthalten), andernfalls wird der Vorgang abgelehnt. Standard: false
githubToken (Optional, verschlüsselt)	GitHub Personal Access Token. Nur erforderlich für private Repositories oder bei ungewöhnlich hoher Nutzungsfrequenz.
allowedBasePathIds (Optional)	Schränkt ein, in welche Ordnerbereiche der Skill heruntergeladen werden darf. Wenn gesetzt, muss der Zielordner unterhalb eines der angegebenen Pfade liegen.

Rückgabewerte

Feld	Beschreibung
uuid	UUID des erstellten Skill-Ordners in agorum core.
name	Name des Skill-Ordners.
objectLink	Link zum Skill-Ordner in agorum core.
filesCreated	Anzahl der heruntergeladenen Dateien.
sourceUrl	Die ursprüngliche GitHub-URL, von der der Skill heruntergeladen wurde.

Fehlerszenarien

Situation	Fehlermeldung
URL zeigt nicht auf einen Skill-Ordner	The given URL does not point directly at a skill folder (no SKILL.md found). Use skill_github_tree to discover available skills first.
Skill-Ordner existiert bereits und overwrite ist false	Skill folder "..." already exists. Use overwrite=true to replace it.
Bestehender Ordner ist kein Skill-Ordner	Refusing to overwrite: target folder is not a skill folder (no SKILL.md found inside).
Repository zu groß für einen einzelnen API-Call	GitHub returned a truncated tree. The repository is too large for a single-call download.

Technische Details

Das Tool verwendet die GitHub Trees API (recursive=1), um die gesamte Repository-Struktur in einem einzigen API-Request zu laden. Anschließend werden die einzelnen Dateien über raw.githubusercontent.com heruntergeladen, was nicht zum GitHub-REST-Rate-Limit zählt. Ein Skill-Download verbraucht daher genau einen API-Request, unabhängig von der Anzahl der Dateien.

Alle Schreiboperationen (Ordner erstellen, Dateien herunterladen, ggf. bestehenden Ordner leeren) laufen in einer Transaktion. Bei einem Fehler werden keine unvollständigen Daten hinterlassen.

Tipps und Tricks