ReferenzMCP-Toolssave_cloud_skill

Tool Reference

save_cloud_skill

Speichern oder aktualisieren Sie ein wiederverwendbares Cloud Skill und erstellen Sie dessen nächste versionierte Revision.

Nur ein überprüftes Verfahren veröffentlichen

Geben Sie dauerhafte Anweisungen und optionale typisierte Komponenten an. Halten Sie Anmeldedaten und private Inhalte aus dem Skill-Text fern; das Tool speichert das Verfahren im authentifizierten persönlichen oder Team-Bereich.

Öffentliches MCP-Tool

save_cloud_skill

Zweck

Ein wiederverwendbares Cloud Skill erstellen oder aktualisieren und die nächste unveränderliche Revision seiner Anweisungen und typisierten Komponenten erzeugen.

Wann zu verwenden

  • Ein bewährtes Agentenverfahren oder eine Arbeitsanweisung soll als wiederverwendbarer Skill veröffentlicht werden.
  • Ein bestehendes Skill erhält eine neue Revision mit verbesserten Anweisungen oder Skriptkomponenten.
  • Teamspezifische Automatisierungen sollen zentral verwaltet und versioniert bereitgestellt werden.

Wann NICHT zu verwenden

  • Speichern Sie keine geheimen Anmeldedaten, Tokens oder privaten Schlüssel im Skill-Text oder in den Komponenten.
  • Verwenden Sie es nicht für flüchtige Prompts oder einmalige Chat-Instruktionen.
  • Verwenden Sie es nicht für allgemeine Wissensdokumente; nutzen Sie Knowledge Bases für Dokumentensammlungen.
  • Erstellen Sie keine neuen Skills, wenn eine Ergänzung bestehender Erinnerungen via remember ausreicht.

Erforderlicher Scope

  • cloud_skill:write (oder memory:write auf Systemen mit vereintem Berechtigungsmodell).
  • Der Aufrufer muss berechtigt sein, Skills im persönlichen oder Team-Bereich zu veröffentlichen.

Parameter

NameTypBeschreibung
namestring · erforderlichLesbarer Name des Skills (z. B. Deploy Service Runbook).
instructionsstring · erforderlichVollständige Markdown-Anweisungen und Verhaltensrichtlinien für den Skill.
slugstring · Standard: derived from nameEindeutiger URL-tauglicher Bezeichner für das Skill (z. B. deploy-service).
descriptionstring · Standard: emptyKurzbeschreibung des Zwecks und der Einsatzszenarien für Suchindizes.
publishboolean · Standard: trueGibt an, ob die neue Revision sofort als aktive Arbeitsversion freigegeben werden soll.
components_jsonJSON array string · Standard: []Optionales JSON-Array typisierter Komponenten (z. B. Skripte, Vorlagen, Referenzen).

Rückgabeschema

Ein JSON CloudSkillResponseEnvelope mit object='cloud_skill', schema_version='xmemo.cloud_skill.v1', kind='root', render_status, warnings und data mit skill_id, slug, name, description, revision_id, revision_number, instructions, canonical_hash und einem typisierten Ressourcenmanifest.

Beispiele

Ein persönliches Verfahren veröffentlichen
save_cloud_skill({
  name: "deployment-procedure",
  instructions: "Check the release, run the smoke test, and report the result.",
  slug: "deployment-procedure",
  description: "A bounded deployment verification procedure",
  publish: true
})

Fehler

  • 401/403: Unzureichende Schreibberechtigung für Cloud Skills.
  • Validierungsfehler: Name oder Anweisungen fehlen, oder Komponenten verletzen das Komponentenschema.
  • Namenskonflikt: Der angegebene Slug existiert bereits in einem anderen unberechtigten Bereich.
  • Sicherheitsblockade: Skriptkomponenten enthalten verbotene Aufrufe oder unsichere Muster.
  • recall_cloud_skill — Gespeicherte Skills und deren Revisionen vor einer Ausführung inspizieren.
  • execute_cloud_skill — Ein freigegebenes Skript aus einer geprüften Skill-Revision ausführen.
  • remember — Ergänzende Kontextdaten zum Einsatz des Skills im Speicher hinterlegen.

Quelle: Cloud Skills