gws-slides

gws-slides skill の概要

gws-slides は、googleworkspace/cli に含まれる Google Slides 用の skill で、gws CLI を通じてプレゼンテーションを読み書きするためのものです。ブラウザ上で Slides を手作業編集するのではなく、デッキを確認したい、作成したい、あるいは構造化された変更を加えたいエージェントに最適です。プロンプトから「このプレゼンを安全に更新したい」という用途なら、gws-slides が最初の起点になります。

gws-slides skill の主な価値は、汎用プロンプトに正しいリクエスト形を推測させるのではなく、コマンド指向のワークフローで Slides API を扱える点にあります。プレゼン更新はスキーマに強く依存しがちで、タイトル、ID、ページリソース、バッチ操作には正しいパラメータが必要です。1つでも崩れると操作全体が失敗することがあります。さらにこの skill では前提条件も明示されており、認証、グローバルフラグ、セキュリティルールのために共有の gws-shared セットアップが必要です。

gws-slides skill でできること

gws-slides は、プレゼンテーションを作成する、現在の状態を取得する、ページやその他のプレゼンテーションリソースにまとめて更新を適用するといった、API ベースの操作が必要な Slides 向けです。単発のコピーライティングよりも、自動化、再現性のある編集ワークフロー、エージェント主導の保守作業に向いています。

gws-slides skill が向いているケース

すでに Google Workspace CLI のエコシステム内で作業したいと決まっていて、具体的な deck ID、タイトル、編集目標を提示できるなら、gws-slides skill を選ぶのが適しています。スライド内容についての提案ではなく、決定論的な変更が必要な場面では特に強い選択肢です。

知っておくべき主な制約

この skill だけで「ゼロから見栄えのよいプレゼンを設計する」ことはできません。目標を有効な Slides API リクエストに落とし込む作業は必要ですし、基本的な探索を超える操作では、実行前にメソッドのスキーマを確認する前提で考えるべきです。視覚的なレイアウト戦略を求めているなら、API 実行よりも一般的なプロンプト手法のほうが扱いやすい場合があります。

gws-slides skill の使い方

gws-slides skill を正しくインストールする

gws-slides のインストールは、リポジトリの CLI パッケージフローを使います: npx skills add googleworkspace/cli --skill gws-slides。インストール後は、SKILL.md に書かれている前提条件を確認してください。認証と共有ルールのために ../gws-shared/SKILL.md が存在している必要があります。このファイルがない場合は、リポジトリの指示に従って gws generate-skills を実行します。

先に読むべきファイルを押さえる

まず skills/gws-slides/SKILL.md を読み、そのあとで参照されている共有 skill ファイルを確認します。最短ルートは次の通りです。

1. コマンドの形とリソース一覧を確認するために SKILL.md
2. 認証と安全制約を確認するために ../gws-shared/SKILL.md
3. 利用可能なリソースとメソッドを見るために gws slides --help
4. 実際のリクエストを組み立てる前に gws schema slides.<resource>.<method>

この順番を踏めば、もっとも起こりやすい失敗、つまり有効なメソッドに対して間違ったフィールドを送ってしまう問題を避けられます。

曖昧な目的を使えるプロンプトに落とし込む

gws-slides をうまく使うリクエストは、resource、method、結果を具体的に示します。「スライドを直して」ではなく、たとえば「deck abc123 の presentations.get の出力を gws-slides で確認し、その後でタイトル名を変更し、1枚目のページ本文を更新する batchUpdate プランを提案して」といった形にします。deck の識別子、変更したい内容の正確な説明、既存レイアウトの維持や内容削除の回避といった制約も含めてください。

スキーマからコマンドへ落とし込む

この skill のワークフローは schema-first です。gws schema で必須パラメータ、オブジェクトの形、デフォルト値を確認し、そのうえで意図する変更を CLI フラグやリクエストボディに対応づけます。特に batchUpdate では、複数の操作がまとめて検証され、1件でも不正なリクエストがあるとバッチ全体が失敗するため、この手順が重要です。

gws-slides skill FAQ

gws-slides skill は上級者向けだけですか？

いいえ。読み取り→スキーマ確認→実行、という流れに従えるなら、初心者でも使えます。通常のプロンプトより構造化されていますが、その構造こそがミスを減らします。

gws-slides skill は通常のプロンプトとどう違いますか？

通常のプロンプトは、プレゼンがどう見えるべきかを説明できます。gws-slides は、プレゼンテーションのリソースを実際に調べ、gws 経由で API ベースの変更を実行できます。実編集にはこちらが向いていますが、その分、有効な識別子とメソッドレベルの詳細をきちんと指定する必要があります。

どんなときに gws-slides skill を使うべきではありませんか？

創造的なスライド案、ざっくりした文章、非技術的なアウトラインだけが必要なら、gws-slides は使わないほうがよいです。また、Google Workspace CLI 環境にアクセスできない場合や、必要な共有認証セットアップがない場合も適しません。

インストール前に何を確認すべきですか？

作業内容が Google Slides API の操作に依存していること、そして前提条件である gws-shared ファイルを用意できることを確認してください。リポジトリや環境がその依存関係を満たせないなら、gws-slides は安定して使いにくくなります。

gws-slides skill を改善する方法

エージェントに deck の文脈を正確に渡す

gws-slides で最も強いプロンプトには、presentation ID、対象リソース、実行したい操作が含まれます。新規 deck なのか既存 deck なのかも明示し、既存のスライド、順序、スピーカーノートを維持する必要があるかどうかも伝えてください。これにより推測が減り、最初のコマンドが有効になる可能性が高まります。

結果だけでなく API メソッドも指定する

この skill は、presentations.get や presentations.batchUpdate のように期待する操作名を明示したときに最もよく機能します。「デッキを更新して」だけでは、エージェントがメソッドを推測する必要があり、不完全な経路を選ぶことがあります。メソッドを意識した依頼のほうが、gws-slides の使い方として質が上がります。

1回目の読み取り後に反復する

実用的な進め方は、まず deck を確認し、その返却構造をもとにリクエストを絞り込むことです。最初の出力を見たあとで、変更したい正確なページ、フィールド、バッチ操作に合わせてプロンプトを狭めます。これは、最初からすべてのスライド詳細を詰め込もうとするより、たいてい効果的です。

batchUpdate の検証失敗に注意する

gws-slides で最もよくある失敗は、バッチ内に不正な request object が入っているケースです。これを避けるには、まず小さなバッチから作り、gws schema でパラメータ名を確認し、各操作が有効だと分かってからまとめるようにします。