gws-slides

Überblick über die gws-slides-Skill

gws-slides ist die Google-Slides-Skill in googleworkspace/cli zum Lesen und Schreiben von Präsentationen über die gws-CLI. Sie eignet sich am besten für Agents, die ein Deck prüfen, ein neues erstellen oder strukturierte Änderungen vornehmen müssen, ohne Slides im Browser von Hand zu bearbeiten. Wenn dein Auftrag lautet: „Aktualisiere diese Präsentation sicher per Prompt“, ist gws-slides der richtige Startpunkt.

Der wichtigste Nutzen der gws-slides-Skill besteht darin, dass sie die Slides API in einen befehlsorientierten Workflow bringt, statt vorauszusetzen, dass ein generischer Prompt die richtige Request-Struktur schon errät. Das ist wichtig, weil Präsentationsänderungen oft schemaempfindlich sind: Titel, IDs, Seitenressourcen und Batch-Operationen brauchen gültige Parameter, sonst kann der gesamte Vorgang scheitern. Außerdem macht die Skill die Voraussetzung klar sichtbar: Für Authentifizierung, globale Flags und Sicherheitsregeln muss das geteilte gws-shared-Setup vorhanden sein.

Wofür gws-slides gedacht ist

Verwende gws-slides für Slide Decks, wenn du API-gestützte Aktionen brauchst, etwa eine Präsentation zu erstellen, den aktuellen Zustand abzurufen oder gebündelte Änderungen an Seiten und anderen Präsentationsressourcen vorzunehmen. Für Automatisierung, wiederholbare redaktionelle Workflows und agentengetriebene Wartungsaufgaben passt sie besser als einmaliges Copywriting.

Wann gws-slides eine gute Wahl ist

Wähle die gws-slides-Skill, wenn du ohnehin im Google Workspace CLI-Ökosystem arbeiten willst und eine konkrete Deck-ID, einen Titel oder ein klares Bearbeitungsziel liefern kannst. Sie ist besonders stark, wenn du deterministische Änderungen brauchst und nicht nur Vorschläge zum Folieninhalt.

Wichtige Einschränkung

Diese Skill ist für sich genommen kein System, mit dem du eine Präsentation komplett „von Grund auf“ gestalten kannst. Du musst dein Ziel weiterhin in gültige Slides-API-Requests übersetzen, und für alles, was über die Grundrecherche hinausgeht, solltest du vor dem Ausführen die Methodenschemata prüfen. Wenn du eher eine visuelle Layout-Strategie als die API-Ausführung brauchst, ist ein generischer Prompt-Ansatz oft einfacher.

So verwendest du die gws-slides-Skill

gws-slides korrekt installieren

Für die Installation von gws-slides nutze den CLI-Paketfluss des Repositories: npx skills add googleworkspace/cli --skill gws-slides. Prüfe nach der Installation die in SKILL.md genannte Voraussetzung: ../gws-shared/SKILL.md muss für Authentifizierung und gemeinsame Regeln vorhanden sein. Fehlt diese Datei, weist das Repository dich an, gws generate-skills auszuführen.

Zuerst die richtigen Dateien lesen

Beginne mit skills/gws-slides/SKILL.md und lies dann die dort referenzierte gemeinsame Skill-Datei. Der schnellste Weg ist:

1. SKILL.md für die Befehlsstruktur und die Ressourcenliste.
2. ../gws-shared/SKILL.md für Authentifizierungs- und Sicherheitsvorgaben.
3. gws slides --help, um die verfügbaren Ressourcen und Methoden zu sehen.
4. gws schema slides.<resource>.<method>, bevor du eine echte Anfrage baust.

Diese Reihenfolge verhindert den häufigsten Fehler: die falschen Felder an eine zwar gültige, aber falsch angesprochene Methode zu senden.

Einen vagen Auftrag in einen brauchbaren Prompt übersetzen

Eine gute gws-slides-Anfrage ist konkret in Bezug auf Ressource, Methode und gewünschtes Ergebnis. Statt „Reparier meine Slides“ zu sagen, formuliere es zum Beispiel so: „Nutze gws-slides, um die Ausgabe von presentations.get für das Deck abc123 zu prüfen, und schlage dann einen batchUpdate-Plan vor, um den Titel umzubenennen und den Text auf der ersten Seite zu aktualisieren.“ Nenne die Deck-ID, die genaue Änderung und mögliche Einschränkungen wie das Beibehalten des bestehenden Layouts oder das Vermeiden von Inhaltslöschungen.

Vom Schema zum Befehl arbeiten

Der Workflow der Skill ist schema-first. Nutze gws schema, um erforderliche Parameter, Objektstrukturen und Defaults zu ermitteln, und überführe dann die geplante Änderung in CLI-Flags oder Request-Bodies. Das ist besonders wichtig bei batchUpdate, weil dort mehrere Operationen gemeinsam validiert werden und ein einziger fehlerhafter Request den gesamten Batch abbricht.

gws-slides-Skill: FAQ

Ist gws-slides nur für Fortgeschrittene?

Nein. Die Skill ist auch für Einsteiger nutzbar, wenn sie einem Workflow aus „Schema lesen, dann handeln“ folgen können. Sie ist strukturierter als ein einfacher Prompt, aber genau diese Struktur reduziert Fehler.

Worin unterscheidet sich gws-slides von einem normalen Prompt?

Ein normaler Prompt kann beschreiben, wie eine Präsentation aussehen soll. gws-slides kann Präsentationsressourcen tatsächlich prüfen und API-gestützte Änderungen über gws ausführen. Das macht sie für echte Bearbeitungen besser geeignet, bedeutet aber auch, dass du gültige Identifikatoren und methodenspezifische Details angeben musst.

Wann sollte ich gws-slides nicht verwenden?

Verwende gws-slides nicht, wenn du nur kreative Folienideen, grobe Texte oder eine nicht-technische Gliederung brauchst. Sie ist außerdem eine schlechte Wahl, wenn du keinen Zugriff auf die Google-Workspace-CLI-Umgebung oder das erforderliche gemeinsame Auth-Setup hast.

Was sollte ich vor der Installation prüfen?

Stelle sicher, dass dein Workflow auf Google-Slides-API-Operationen angewiesen ist und dass du die Voraussetzung gws-shared erfüllen kannst. Wenn dein Repository oder deine Umgebung diese Abhängigkeit nicht abbilden kann, lässt sich gws-slides nur schwer zuverlässig einsetzen.

So verbesserst du die gws-slides-Skill

Gib dem Agenten den exakten Deck-Kontext

Die stärksten gws-slides-Prompts enthalten die Präsentations-ID, die Zielressource und die beabsichtigte Aktion. Wenn das Deck neu ist, sag das ausdrücklich; wenn es bereits existiert, gib an, ob die Änderung die aktuellen Folien, die Reihenfolge oder die Sprecher-Notizen erhalten muss. Das reduziert Rätselraten und erhöht die Chance, dass der erste Befehl gültig ist.

Frage nach der API-Methode, nicht nur nach dem Ergebnis

Die Skill funktioniert am besten, wenn du die erwartete Operation nennst, etwa presentations.get oder presentations.batchUpdate. Wenn du nur „Update das Deck“ schreibst, muss der Agent die Methode ableiten und wählt womöglich einen unvollständigen Weg. Methodenspezifische Anfragen führen zu besserem gws-slides-Einsatz.

Nach dem ersten Einlesen iterativ nachschärfen

Ein praktikabler Workflow ist: zuerst das Deck prüfen, dann die Anfrage auf Basis der zurückgegebenen Struktur verfeinern. Nach der ersten Ausgabe solltest du den Prompt auf die genaue Seite, das Feld oder die Batch-Operation zuspitzen, die geändert werden soll. Das ist meist wirksamer, als von Anfang an jedes Foliendetail festzunageln.

Auf Validierungsfehler bei batchUpdate achten

Der häufigste Fehlerfall bei gws-slides ist ein ungültiges Request-Objekt innerhalb eines Batches. Um das zu vermeiden, baue kleinere Batches, prüfe Parameternamen mit gws schema und kombiniere Operationen erst dann, wenn jede einzelne als gültig bestätigt ist.