Communitygithub.com

sharonzhang98/editorial-pptx-deck

Cursor Agentスキル:HTMLスライドから編集可能なエディトリアル・ミニマリストなビジネスPPTXデッキを構築します。

editorial-pptx-deck とは?

このスキルは、エディトリアル・ミニマリストスタイルのビジネススライドデッキを、HTMLスライドをソースとして編集可能なPPTX形式で生成するためのCursorエージェントスキルです。 **主な目的と価値:** - デザインの一貫性を保ちながら、高品質なビジネスプレゼンテーションを迅速に作成できます。 - 最終成果物はPPTXのみであり、PowerPoint上で自由に編集可能です(テキストボックス・画像・図形などがネイティブオブジェクトとして保持されます)。 **対応プラットフォーム:** - Cursor(エージェントモード) - Claude Code, Codex, Cline, Copilotなど、エージェント型AIツール全般で使用可能です。 **仕組み:** 1. 各スライドを制約付きHTML(1ファイル1スライド、1280×720px固定)として記述します。 2. ビルドスクリプト (`scripts/html2pptx.js`) が各DOM要素をネイティブPowerPointオブジェクトに変換。 3. テンプレートカタログ(カバー、仕切り、3カラム、比較表など)から選択し、テキストのみを差し替えます。 4. デザインシステム (`shared/tokens.css`) で色・タイポグラフィ・レイアウトが厳密に定義され、`--red` を変えるだけでブランド変更が可能です。 5. オーバーフローチェッカー (`scripts/check_overflow.mjs`) で全スライドの正確なサイズを検証し、失敗のない変換を保証します。 **ワークフロー:** - プロジェクトのスキャフォールディング → ストーリー設計 → HTML記述 → オーバーフローチェック → PPTXエクスポート → ビルドソースのクリーンアップ。 - 写真ライブラリも付属(ポートレート・ランドスケープ画像)し、統一感のあるビジュアルを簡単に適用できます。 このスキルは、デザインの手間をかけずにプロフェッショナルなスライドデッキを生成したい開発者やAIエージェントユーザーに最適です。

対応~Claude Code~Codex CLI✓Cursor
npx skills add sharonzhang98/editorial-pptx-deck

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

プレビュー

スキル README より

editorial-pptx-deck preview

ドキュメント

エディトリアルPPTXデッキ

洗練されたエディトリアル・ミニマリストスタイルのスライドデッキを作成し、編集可能なPPTXとしてエクスポートします。最終成果物は .pptx のみです。HTMLスライドはビルドソースに過ぎず、PDFやHTMLビューアは生成しません。

仕組み

スライドは制約付きHTML(スライドごとに1ファイル)で作成し、その後 scripts/html2pptx.js が各DOM要素をネイティブのPowerPointオブジェクト(ダブルクリックで編集可能な実際のテキストボックス)に変換します。ボディサイズは 1280px × 720px = 960pt × 540pt に固定されています(LAYOUT_WIDE)。

ビルドワークフロー

以下のチェックリストをコピーして進捗を追跡してください:

- [ ] 1. プロジェクトのスキャフォールディング(shared/ assets/ slides/ output/)
- [ ] 2. ナラティブを計画 → 各スライドをテンプレートタイプにマッピング
- [ ] 3. テンプレートから slides/NN-name.html を作成(テキストのみ編集)
- [ ] 4. check_overflow を実行 → 1280x720 に合わないスライドを修正
- [ ] 5. PPTXのみエクスポート
- [ ] 6. ビルドソースをクリーンアップ(.pptx のみ保持)

1. スキャフォールディング。 作業プロジェクト内に shared/、assets/、slides/、output/ を作成します。このスキルから shared/tokens.css をプロジェクトの shared/ にコピーします。このスキルの assets/ から使用する写真のみをプロジェクトの assets/ にコピーします。依存関係を一度インストールします:

npm i pptxgenjs playwright sharp && npx playwright install chromium

2. 計画。 ソースコンテンツをスライドリストに変換します。すべてのスライドはテンプレートタイプのいずれかです。典型的なデッキの構成 = カバー → (仕切り → 1~3枚のコンテンツスライド)× セクション → クロージング。テキストは簡潔に保ちます。このスタイルは風通しの良いデザインです。

3. スライド作成。 templates/ から最も近いテンプレートを slides/NN-name.html にコピーし、テキストを置き換えます。規則:

  • <link rel="stylesheet" href="../shared/tokens.css"> を維持します。
  • タイトルはセリフ体、その他はすべてサンセリフ体を使用します(トークンですでに設定済み)。
  • アクセントカラーは赤色1色のみ。ダークパネル(--ink-panel)は控えめに使用し、その唯一のアクセントとしてゴールド #C9A24B を使用します。
  • 写真は <img> で配置します(CSS background-image は不可)。写真ライブラリを参照してください。

4. 適合確認。 オーバーフローするスライドはPPTXでクリップされます:

node scripts/check_overflow.mjs --slides slides

OVERFLOW とフラグされたものを修正(テキストを短くするか位置を調整)し、すべてが 1280x720 と報告されるまで繰り返します。

5. PPTXのみエクスポート。

node scripts/export_deck_pptx.mjs --slides slides --out output/DeckName.pptx

スライドはファイル名でソートされます(01-…、02-…)。PDF/HTMLエクスポートは実行しないでください。PPTXが唯一の成果物です。

6. クリーンアップ。 slides/ 内のHTMLと一時ファイルを削除し、output/DeckName.pptx のみを残します(反復作業のために再利用可能な shared/ + assets/ は残しても構いません)。

デザインシステム

shared/tokens.css で定義されています。新しい色を作成しないでください。

トークンHEX用途
--ink#1A1A1Aタイトルおよび主要な本文
--soft#555555二次的な本文
--muted#8C8C8Cラベル、注釈、ページ番号
--red#C8102E唯一のアクセント:バー、キッカー、キーワード、下線
--red-deep#A00C24テーブル内の強調(ネガティブ)
--red-pale#FBE9ECコネクタチップ(例:「→」の丸)
--box#F4F3F1ライトカード / ゼブラ行
--line#E4E2DE極細の区切り線
--ink-panel#1C1C1Cダークコントラストパネル
gold#C9A24Bダークパネル上のみのアクセント
background#FFFFFFページ背景
  • タイポグラフィ: 見出し(h*)やタイトルはGeorgiaセリフ体。それ以外はArial/Helveticaサンセリフ体。
  • シグネチャ: タイトルの左側にある細い赤い縦棒、その上に小さな字間を空けた赤いキッカー、下部中央に小さなページ番号。
  • ブランド変更: 他の企業に合わせるには、tokens.css の --red(およびオプションで --ink-panel/gold)を変更するだけで完了です。他は何も変える必要はありません。

写真ライブラリ

写真はこのスキルの assets/ にあります。ポートレート画像は右側約40%の仕切り/カバーパネルを埋めます(object-fit:cover)。ランドスケープ画像は全面カバーに適しています。

ファイル向き最適な用途
sail.pngポートレート 589×1024仕切り / カバー右パネル(デフォルト)
lighthouse-cliff.pngポートレート 627×1024仕切り / カバー右パネル
staircase.png縦長 312×1024落ち着いた/抽象的な仕切り帯
mast.png細長 208×1024細い仕切り帯
hiker-clouds.png細長 225×1024細い仕切り帯
lighthouse-sunset.pngランドスケープ 1024×721全面カバー / 上部バンド
sailboat-deck.pngランドスケープ 1024×721全面カバー / 上部バンド

写真を変更するには、<img src="../assets/….png"> を差し替えます。統一感を持たせるために、すべての仕切りで一貫した1枚の写真(または1つのモチーフ)を使用してください。ユーザーは自分の画像を assets/ に追加することもできます。

テンプレートカタログ

templates/ にあります(各ファイルはオーバーフローなしの完全な1280×720スライドです):

ファイルタイプ
01-cover.html分割カバー:左にセリフタイトル、右にポートレート写真
02-divider.htmlセクション仕切り:キッカー + セリフタイトル + 赤いバー、右にポートレート写真
03-three-column.htmlキッカー/タイトル + コアライン + 3カラム + 結果ストリップ
04-mapping.html2カラムの「相手のニーズ→私たちの提供」とコネクタチップ
05-compare-table.html3カラム比較表、ゼブラ行
06-dark-contrast.html2パネル(ライト vs ダーク)+ セリフフッターライン
07-pipeline.html番号付き横型ステップパイプライン + ダーク出力バー
08-closing.htmlクロージングピッチ:番号付きセリフ行 + 右にポートレート写真

ハード制約

以下のルールを破るとHTML→PPTX変換が失敗するか、レンダリングが崩れます。詳細と修正方法は reference.md を参照してください:

  1. テキストは <p> / <h1>~<h6> の中にのみ配置(<div> 内に裸のテキストを置かない)。
  2. CSSグラデーションは使用禁止。
  3. background / border / box-shadow は <div> にのみ適用、テキストタグには使用しない。
  4. background-image は使用禁止。<img> を使用する。
  5. インラインタグ(span / em / strong)にマージンを設定できない。
  6. ボディサイズは1280×720に固定。要素がはみ出してはならない。

関連スキル