figma-slides

figma-slides — Figma Slides のデッキを作成する

Figma Slides のプレゼンテーションを作成・編集します。スライドグリッドの管理（一覧表示／作成／複製／並べ替え ／削除／フォーカス／スキップ）、コンテンツの追加（テキスト、図形、背景色）、トランジションの制御を行います。各スライドは SLIDE ノードで、デッキは2次元グリッドです（figma.getSlideGrid() → スライドの行）。

スキルの範囲

• use_figma のルール — まず公式の figma-use スキルを読み込んでください。これは Figma Plugin API の完全なリファレンスです。これらのスクリプトが前提とする基本事項：トップレベルの await と return を使ったプレーンな JS（IIFE や figma.closePlugin() は使わない。console.log の結果は返されない）、各スクリプトの先頭で入力を const としてインライン化する、色の範囲は0～1、テキスト操作の前にフォントを読み込む、await figma.getNodeByIdAsync(...) を使う、そして アトミックエラー（スクリプトが失敗すると変更は一切適用されません。エラーを読み、修正して再試行してください）。
• 操作ごとに1つの完全なスニペット → references/slides-snippets.md。

ワークフロー

1. Slides ファイルであることを確認します。 Slides 以外では、すべての操作がエラーになります。最初に確認してください： return { editorType: figma.editorType }; — 値が 'slides' である必要があります。
2. スライドを一覧表示して、ID とグリッド上の位置を取得します（scripts／スニペット List slides）。スライド ID は、他のすべての操作で参照する ID です。
3. references/slides-snippets.md から操作を選択します：スライドの作成／複製／削除／並べ替え、テキスト／図形の追加、背景の設定、トランジションの設定／取得、フォーカス、スキップ、スライドコンテンツの読み取り。
4. 定数をインライン化して編集し、use_figma（skillNames: "figma-slides"）経由でスニペットを実行します。
5. 作成／変更したスライド ID を返し、一覧表示またはコンテンツの読み取りを再度行って確認します。

注意事項

• テキストを追加する前にフォントを読み込みます。 add text to slide は .characters を設定する前に await figma.loadFontAsync({ family, style }) を呼び出します。必ず実行してください。デフォルトは Inter／Regular です。
• figma.createSlide({ row, col }) でグリッド上の位置を指定して作成するか、figma.createSlide() で末尾に追加します。
• トランジションの style 値：NONE、DISSOLVE、SLIDE_FROM_LEFT、SLIDE_FROM_RIGHT、 SLIDE_FROM_BOTTOM、SLIDE_FROM_TOP、PUSH_FROM_LEFT、PUSH_FROM_RIGHT、PUSH_FROM_BOTTOM、 PUSH_FROM_TOP、SMART_ANIMATE。タイミングのデフォルトは { type: 'ON_CLICK' } です。
• 背景は、全面を覆う（1920×1080）Background 長方形として実装され、インデックス0に挿入されます。再実行すると重ねて追加するのではなく、既存のものが更新されます。
• reorder はスライド ID の2次元配列（行 × 列）を受け取り、figma.setSlideGrid でグリッドを再構築します。すべての ID が現在のグリッドに存在しない場合、エラーになります。
• スキップでは slide.isSkippedSlide を切り替えます（注意：プロパティ名は skipped ではなく isSkippedSlide です）。
• これらのツールを使用するには Figma Desktop アプリが必要です（Plugin API はブラウザーでは利用できません）。