gws-drive
von googleworkspacegws-drive ist die Google-Drive-Skill für die Google Workspace CLI. Verwende sie, um Dateien, Ordner, freigegebene Ablagen, Zugriffsanfragen und API-gestützte Drive-Workflows mit weniger Rätselraten zu verwalten. Sie eignet sich besonders für Backend-Entwicklung, Automatisierung und wiederholbare Aufgaben in der Kommandozeile.
Diese Skill erreicht 78/100 und ist damit ein solider Kandidat für die Aufnahme: Verzeichnisnutzer können sie wahrscheinlich mit dem Muster `gws drive <resource> <method> [flags]` anstoßen und erhalten echte Google-Drive-Workflow-Abdeckung, sollten sich aber auf die breitere Voraussetzung `gws-shared` für Authentifizierung und Regeln stützen. Der Inhalt ist ausführlich genug, um eine Installationsentscheidung zu unterstützen, aber nicht so vollständig, dass er sich für Erstnutzer sofort schlüsselfertig anfühlt.
- Starker Funktionsumfang: Deckt die Verwaltung von Google Drive über Ressourcen wie about, accessproposals und viele Drive-API-Methoden ab, nicht nur eine enge Demo.
- Gute Auslösbarkeit: Die explizite Befehlsstruktur, gültiges Frontmatter und die repo-gestützte Hilfe-Referenz (`gws drive --help`) erleichtern es Agents, den Skill korrekt aufzurufen.
- Sinnvolle schrittweise Detaillierung: Ein Hilfsbefehl verweist auf upload-spezifische Hinweise, und der Text enthält API-nahe Anmerkungen und Einschränkungen für bestimmte Vorgänge.
- Kein Installationsbefehl in SKILL.md und keine Support-Dateien oder Scripts, daher hängen Einrichtung und Ausführung vom externen Repository-Kontext und vom gemeinsamen Voraussetzungsskill ab.
- Der Skill ist eher auf API-Methoden als auf konkrete Aufgabenabläufe ausgerichtet, was Agenten bei End-to-End-Workflows etwas Spielraum für Interpretation lassen kann.
Überblick über den gws-drive Skill
Was gws-drive macht
gws-drive ist der Google Drive Skill für die Google Workspace CLI. Er hilft Ihnen dabei, Dateien, Ordner, Shared Drives und zugehörige Drive-API-Workflows direkt über die Kommandozeile zu verwalten – mit der skill-spezifischen Orientierung, die nötig ist, um nicht bei Ressourcennamen, Pflichtfeldern und Berechtigungsgrenzen zu raten.
Für wen der Skill gedacht ist
Nutzen Sie den gws-drive Skill, wenn Sie im Bereich Backend Development, Automation oder Ops arbeiten und wiederholbare Drive-Aktionen in Skripten oder Agent-Workflows benötigen. Besonders nützlich ist er, wenn Sie für Drive-Aufgaben einen CLI-gestützten Prozess statt einer einmaligen Prompt-Antwort wollen, vor allem bei Uploads, metadatenbewussten Operationen und API-gestützten Abfragen.
Was vor der Installation wichtig ist
Der Hauptvorteil von gws-drive liegt nicht in der Breite, sondern in der Verlässlichkeit: Der Skill führt den Agenten zu den richtigen Drive-Ressourcen und zur passenden Request-Struktur. Die größte Hürde bei der Einführung sind Authentifizierung und gemeinsam genutzte Voraussetzungen, da der Skill von der breiteren gws-Umgebung und den gemeinsamen Anweisungen in gws-shared für Flags und Sicherheitsregeln abhängt.
So verwenden Sie den gws-drive Skill
Installation und Prüfung der Voraussetzungen
Installieren Sie den gws-drive Skill im Kontext der Google Workspace CLI und prüfen Sie zuerst die gemeinsame Voraussetzung: ../gws-shared/SKILL.md. Die Skill-Metadaten erwarten außerdem, dass das gws-Binary verfügbar ist, also vergewissern Sie sich, dass die CLI funktioniert, bevor Sie einen Drive-Workflow starten. Ein sinnvoller Installationsweg ist, nach dem Setup gws drive --help aufzurufen und es mit der Ressourcenliste des Skills abzugleichen.
Mit der richtigen Eingabeform starten
Das Nutzungsmuster von gws-drive ist gws drive <resource> <method> [flags], daher sollte Ihr Prompt Zielressource, Aktion und genaue Ausgabeanforderungen benennen. Stark ist eine Eingabe wie: „Liste alle Shared Drives auf, auf die ich Zugriff habe, gib nur name und id zurück und schließe den Papierkorb aus.“ Schwach ist: „Prüf Drive.“ Wenn Sie den gws-drive Leitfaden für Backend Development verwenden, nennen Sie Identifikatoren, übergeordnete Ordner und alle Annahmen zu Berechtigungen oder Scopes gleich am Anfang.
Diese Dateien zuerst lesen
Beginnen Sie mit SKILL.md und sehen Sie sich danach ../gws-shared/SKILL.md an, weil dort Authentifizierung, globale Flags und Sicherheitsverhalten festgelegt sind. In diesem Repo-Ausschnitt gibt es keine Hilfsskripte oder unterstützenden Ordner, auf die man ausweichen könnte, daher ist die Skill-Datei selbst die primäre Quelle. Achten Sie besonders auf die Abschnitte zu API-Ressourcen und den Hilfsbefehl +upload, denn sie zeigen den vorgesehenen Workflow, statt Sie aus generischer Drive-Dokumentation etwas ableiten zu lassen.
Workflow, der bessere Ergebnisse liefert
Arbeiten Sie in drei Schritten: Ressource festlegen, Methode eingrenzen und dann nur die Flags ergänzen, die die API-Antwort beeinflussen. Wenn Sie zum Beispiel Drive-Kontoinformationen abrufen möchten, sollte die Anfrage erwähnen, dass der Aufruf about.get fields erfordert; Upload-bezogene Aufgaben sollten über den Hilfsbefehl laufen, wenn Sie automatische Metadaten wollen. Das ist die zentrale gws-drive Arbeitsdisziplin: die kleinste nützliche Antwort anfordern, nicht die größtmögliche.
gws-drive Skill FAQ
Ist gws-drive nur für die Grundlagen von Drive gedacht?
Nein. gws-drive deckt die zentralen Drive-Ressourcen sowie bestimmte API-Verhaltensweisen ab, die für Automatisierung wichtig sind, etwa dass about.get fields benötigt und dass Access-Proposals nur mit Approver-Beschränkungen behandelt werden können. Dadurch eignet sich der Skill besser als ein allgemeiner Prompt, wenn Ihre Aufgabe von der korrekten API-Form und nicht nur von einer groben Drive-Erklärung abhängt.
Wann sollte ich diesen Skill nicht verwenden?
Überspringen Sie den gws-drive Skill, wenn Sie nur einen manuellen, einmaligen Drive-Tipp brauchen oder wenn die gws-CLI und das gemeinsame Auth-Setup noch nicht bereit sind. Er ist auch dann eine schlechte Wahl, wenn Ihre Aufgabe gar nicht mit Drive-Operationen zu tun hat, weil der Skill auf Request-Erstellung und CLI-Ausführung optimiert ist, nicht auf allgemeine Workspace-Beratung.
Ist er anfängerfreundlich?
Ja, wenn Sie ein konkretes Drive-Ziel beschreiben können. Der Skill reduziert Rätselraten, indem er das Muster aus Ressource und Methode sowie die wichtigsten Stolpersteine sichtbar macht, aber Einsteiger müssen trotzdem eine Ziel-Datei, einen Ordner, ein Shared Drive oder ein Berechnungsszenario für Berechtigungen nennen. Ohne diese Angaben kann der Agent einen vagen Befehl erzeugen oder einen unnötig breiten API-Aufruf wählen.
Was ist der größte Unterschied zu einem normalen Prompt?
Ein normaler Prompt erklärt möglicherweise Drive-Konzepte; gws-drive gibt Ihnen einen Workflow, der an die tatsächliche CLI und die API-Ressourcen gebunden ist. Das ist entscheidend, wenn Sie einen deterministischen Befehl, eine gültige Feldauswahl oder eine berechtigungsbewusste Operation benötigen, die beim ersten Lauf nicht scheitern sollte.
So verbessern Sie den gws-drive Skill
Geben Sie dem Agenten den exakten Drive-Kontext
Die besten Ergebnisse entstehen, wenn Sie Ressource, Aktion und Umfang in einem Satz nennen. Beispiel: „Verwende gws-drive, um Dateien im Ordner abc123 aufzulisten, gib id, name, mimeType und modifiedTime zurück und schließe gelöschte Elemente aus.“ Das ist deutlich besser als „Suche Dokumente“, weil es Suchunschärfe reduziert und unnötige API-Ausgaben vermeidet.
Nennen Sie Einschränkungen, die den API-Aufruf verändern
Sagen Sie dazu, ob Sie Shared Drives, einen bestimmten Ordner, eine Access Proposal oder Informationen auf Kontoebene benötigen. Bei gws-drive sind diese Details wichtig, weil unterschiedliche Ressourcen unterschiedliche Berechtigungen und Antwortanforderungen haben. Wenn Sie sie weglassen, scheitert die erste Ausgabe oft an fehlenden fields, fehlendem Approver-Zugriff oder einer zu breiten Abfrage.
Vom Befehl zum Ergebnis iterieren
Wenn die erste Ausgabe zu breit ist, schärfen Sie die Anfrage, indem Sie optionale Ausgaben entfernen und die exakten Identifikatoren ergänzen, die Ihnen wichtig sind. Wenn sie fehlschlägt, prüfen Sie, ob das Problem an der Authentifizierung, an fehlenden Voraussetzungen aus gws-shared oder an einer nicht passenden Ressource-Methode-Kombination liegt. Der schnellste gws-drive-Leitfaden-Workflow besteht darin, zuerst die Form des Befehls zu korrigieren und erst danach die Aufgabe selbst zu ändern.