Skip to content
cccskills
FreePublished on GitHub

consulting-pptx-skill

スライド設計規約 slide-rules.md を核に、経営会議品質のスライドを作るスキル。作成前に規約を読み、HTMLパーツ集(基本27+追加35の62型)から該当パーツをコピーして組み、規約の範囲で型に囚われず調整し、check_deck.py の機械チェック FAIL 0 で仕上げる。

型カタログはレイアウトの発想帳であり、合わせる対象ではない。既存の PowerPoint 資料を渡され、そこへ差し込むページを PPTX で求められたときだけ、その資料のマスターの上に直接組む(slide-rules §8.7)。

トリガー例:「コンサル品質のスライドを作って」「規約に沿ったデッキで」「型カタログから選んで」「この pptx に足すページを同じ書式で」。

The English summary is being prepared. Showing the original description.

See how to install

Files included (25)

  • SKILL.md12.7 KB
  • .gitignore295 B
  • assets/SlideCatalog_16x9.pdf2.0 MB
  • assets/SuperTemplate_62type.pptx280.1 KB
  • examples/house_deck_example.py4.4 KB
  • LICENSE1.0 KB
  • package.json388 B
  • README.md14.2 KB
  • references/ai-smell-lexicon.md5.8 KB
  • references/archetype-catalog.md9.6 KB
  • references/content-review-prompt.md6.8 KB
  • references/slide-rules.md80.4 KB
  • scripts/check_deck.py33.9 KB
  • scripts/check_layout.mjs5.9 KB
  • scripts/deck_pptx.py22.1 KB
  • scripts/html_dump.mjs22.2 KB
  • scripts/html_to_pptx.py13.9 KB
  • scripts/lib_cdp.mjs3.8 KB
  • scripts/measure_deck.py17.3 KB
  • scripts/new_deck.py9.6 KB
  • templates/freeform_parts_16x9.html60.1 KB
  • templates/freeform_parts_more_16x9.html108.9 KB
  • tests/fixtures/good_deck.html75.8 KB
  • tests/test_checks.py5.4 KB
  • tests/test_house_pptx.py9.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

コンサル型スライド作成スキル

主軸は references/slide-rules.md。作成前に全文を読み、HTMLパーツ集でたたき台を組み、規約の範囲で調整し、機械チェック FAIL 0 と目視で仕上げる。パーツ集と型カタログは規約を効率よく満たす道具であり、スライドを型に合わせるのではなく、型をストーリーに合わせて選び、合わなければ捨てて自由に組む。

成果物は HTML(16:9・1 section = 1スライド)と、Chrome で印刷した PDF。

ファイルと読むタイミング

ファイル中身読む・使うタイミング
references/slide-rules.md規約の正典必読。作成前に全文
references/archetype-catalog.md62型の一覧(型ID・型名・使いどころ・どのパーツ集の何番か)ストーリーラインの各行に見せ方を書くとき
references/content-review-prompt.mdフレッシュアイ・レビューの指示文機械チェック通過後、納品前
references/ai-smell-lexicon.mdAI臭ワード・言い回しのリスト文章の仕上げ時
templates/freeform_parts_16x9.html基本パーツ集 27(表紙・全体マップ・矢羽・前提→帰結・軸のある表・主張パネル・評価表・分布図など)。まずここから手順3
templates/freeform_parts_more_16x9.html追加パーツ集 35(エグゼクティブサマリー・積み上げ棒・ブリッジ・散布図・比較表・マトリクス・ロードマップ・ガントなど)。基本で足りないとき手順3
assets/SlideCatalog_16x9.pdf両パーツ集を印刷した62ページ(P.1〜27 基本、P.28〜62 追加)型を目で探すとき
scripts/new_deck.pyパーツ番号を並べて1本のHTMLを生成手順3
scripts/check_deck.py規約の機械チェック(HTML は標準ライブラリのみ)手順6
scripts/check_layout.mjs重なり・はみ出し・空きの多いページの実レンダリング検査(npm run setup で playwright を入れる)手順7
tests/test_checks.py機械チェックの自己テスト(直していない版で発火し、直した版で通ることを確認)機械チェックを足した・直したとき
scripts/html_to_pptx.py仕上げた HTML を編集できる PPTX に変換(html_dump.mjs・lib_cdp.mjs を使う)ユーザーが PPTX を明示したときだけ
assets/SuperTemplate_62type.pptx62型のPPTX見本帳(全スライド編集可能)PPTX を手で組むとき
scripts/measure_deck.py既存の PowerPoint 資料の書式を測って skin.json に書き出す既存の資料へ差し込むページを作るとき(最初に)
scripts/deck_pptx.pyその資料のマスターの上に、同じ書式のページを組む部品(作例は examples/house_deck_example.py)同上

規約の要点(入口。全文は必ず読む)

  • タイトル: 結論を書く。1行が基本、長ければ意味の切れ目で2行(縮小して詰めない)。です/ます禁止。タイトルだけ通し読みして1本のストーリーになること
  • レイアウト: 1スライド=1メッセージ。左=事実・図、右=意味合い。下部の「POINT」帯禁止
  • 表: 行=項目・列=観点の「軸のある表」。ヘッダーは本文より大きく太字・塗りなし。最終行の下に罫線なし
  • 装飾: 角丸禁止。塗りボックスに枠線なし。色分けするなら同一スライドに凡例
  • 図: 推移・構成比・分布はグラフで描く。表に流し込んで済ませない(§5.11)
  • 数: タイトルに書いた数と本文の連番を一致させる(§2.9)。ページの中身の個数はタイトルに書かない(§2.4)
  • 文章: 1資料1用語。略語は初出でフル表記。ブレット語尾は階層内で統一

手順

  1. 作る前に定義する: 目的・成果物の定義・スコープ IN/OUT を3〜5行で先に合意する。
  2. ストーリーライン(1枚1行のタイトル列)を書き、各行に見せ方を併記する(図/表/矢羽/2カラム/数値カード)。推移・構成比・分布・相関は必ず図。見せ方に迷う行は references/archetype-catalog.md を見る。
    • 章扉は b27(アジェンダ再掲型)。section は s chap でページ番号に数えない(§4.45)。10枚前後なら章扉は要らない。
    • 表の列幅: 列の内容が同種(時点・案・部門)なら <table class="eq"> で等幅にし、最後の列だけに余白を吸わせない。説明・ブレットの列があるときだけ、その列に余白を渡す。
    • 枚数に上限があるときの削る順: 章扉・目次 → 全体マップと重複する本文 → 補足・付録。表紙・全体マップ・結論ページ・裏表紙は残す。リスクの列挙は対応策と同じ1枚にする(§4.29)。
  3. たたき台を生成する:
    python3 scripts/new_deck.py --list                                   # 番号と型名(b01〜b27 基本/m01〜m35 追加)
    python3 scripts/new_deck.py --parts b01,b02,m05,b06,b09,b10 --title "資料名" -o mydeck.html
    
    両パーツ集のCSS結合・見出し様式の統一・ページ番号の振り直しはスクリプトが行う。手でコピーして組まない。生成後、プレースホルダー(Text N / ラベル N / YYYY)を実物に差し替える。
  4. グラフが要るページは、表パーツに流し込まず自分で描く。
  5. 調整: 表を2枚に割る、右カラムを帰結形に書き直す、粒度の揃わない並列を書き直す。1枚ごとに「この型のままでよいか」を疑う。受けた指摘は slide-rules.md に1行追記し、測れる指摘は機械チェックにもする(slide-rules §8「指摘は規約1行と機械チェックの両方にする」)。
  6. python3 scripts/check_deck.py mydeck.html → FAIL 0(表紙・裏表紙・章扉の「タイトル空」WARN は許容)。出力されるタイトル一覧を通し読みする。本文に残ったプレースホルダー、型名のままのタイトル、2文以上詰めた文章塊も FAIL になる。
    • 社外に出すデッキは、顧客名・社内語・案件コードを1行1語で書いたリスト(リポジトリの外に置く)を当てる: python3 scripts/check_deck.py mydeck.html --forbid ~/.config/deck-forbidden-terms.txt。HTMLコメントや属性に残った語も拾い、語そのものは出力に出さない。
  7. node scripts/check_layout.mjs mydeck.html → OK(playwright が別の場所にあるなら PLAYWRIGHT_MODULE_DIR で指す)。版面の40%超が空いたページも FAIL になる。
  8. フレッシュアイ・レビュー: references/content-review-prompt.md の指示文を、作り方を伏せた別のエージェントに渡してデッキのファイルを読ませる。指摘を採否表(採用/不採用/保留+理由)にし、採用分だけ直して手順6・7を再実行する。
  9. PDF 化して全ページ目視する。 機械チェックは重なり・はみ出し・規約違反しか見ない。棒が潰れる、図が空になる、下半分が空く、泣き別れ、左右の下端不揃いは目視でしか分からない。パーツのCSSは自分のデッキ側で直してよい(直したら templates/ にも反映する)。
    "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --headless --disable-gpu \
      --no-pdf-header-footer --print-to-pdf=mydeck.pdf mydeck.html
    

PowerPoint(.pptx)が要るとき

資料は HTML で仕上げる。PPTX にするのは、ユーザーが「PPTX で」「パワポにして」と明示したときだけ。 修正・レビューの往復はすべて HTML 上で回し、変換は最後に1回だけにする。HTML のほうが直すのも機械チェックも速く、PPTX で直すと HTML と中身がずれる。PPTX を渡した後に修正が来たら、HTML を直して変換し直す。明示が無ければ PDF で渡す。

  1. HTML で手順6〜9(機械チェック FAIL 0・フレッシュアイ・レビュー・PDF 目視)まで済ませる
  2. 変換: python3 scripts/html_to_pptx.py mydeck.html → 同じフォルダに mydeck.pptx(Node 22+・Chrome・pip3 install python-pptx が必要)
  3. python3 scripts/check_deck.py mydeck.pptx を FAIL 0 に。PowerPoint で開いて(または PDF に書き出して)文字の折り返しと重なりを目視する
  4. 社外に送るなら、ファイルのプロパティ(作成者・会社名など)を消す

変換の中身と限界(詳細は slide-rules.md §8.6):

  • 編集できる形で再現: 文字(書体・大きさ・色・行間・折り返し幅・箇条書き書式)、塗りと枠(角丸・clip-path の多角形・CSS の三角形)、罫線、表(結合セル・セルの塗り・罫線・余白・縦書き)
  • 画像になる(中の文字や数値は編集できない): SVG のチャート・図、img、背景画像
  • 書体は和文ゴシック=Yu Gothic、明朝=Yu Mincho に置き換える。字幅の差で行末が1字ずれることがあるので目視は省かない
  • 再現しない: 回転・変形(CSS の transform)、::before/::after で描いた装飾(背景付きの丸数字など。行頭記号の文字は箇条書き書式として再現する)。これらはパーツ側で使わないか、変換後に PowerPoint で直す

PPTX を一から手で組むときの見本として assets/SuperTemplate_62type.pptx(62型・全スライド編集可能)も置いてある。

既存の資料へ差し込むページ

入れる先の PowerPoint 資料(社内の標準デッキ・作りかけの提案書)を渡されたときは、変換せずに その資料のマスターの上で直接組む。変換した PPTX は書体と版面が自前なので、差し込むと浮く(slide-rules §8.7)。文章・表の軸・1枚1メッセージの規約はそのまま。

  1. 測る: python3 scripts/measure_deck.py house.pptx → house.skin.json。要約を読み、資料を目で見て値を直す
  2. 組む: examples/house_deck_example.py を手本に scripts/deck_pptx.py で組む。書体・地色・ページ番号をスライドに書かない/タイトルはプレースホルダー/表はテキストボックス+罫線(table())/色は資料のテーマ色
  3. python3 scripts/check_deck.py pages.pptx --house house.skin.json → FAIL 0。PowerPoint で開く前に必ず通す(不正なファイルを開かせると、ユーザーの PowerPoint に修復のダイアログが残る)
  4. 全ページを目視する(手段は slide-rules §8 の目視QAと同じ)
  5. 渡すのは差し込むページだけのファイル。資料へ入れるのはユーザー(「貼り付け先のテーマを使用」)

本スキル使用の注釈

「本資料は consulting-pptx-skill(github.com/carnot-tech/consulting-pptx-skill)で作成」の一文は裏表紙(b10)の左下に既定で入っている。他のページには入れない。裏表紙を使わないデッキでは最終ページの出典行に足す。

色と書体

両パーツ集の既定は同じ暖色系(生成りの地・濃茶の文字・茶のアクセント。本文ゴシック・見出し明朝)。トークンは各ファイルの <style> 冒頭 :root。片方を変えたらもう片方も揃える。ネイビー系の値はコメントで同梱。意味を持つ色(✕の赤など)は変えない。2系列の区別はメインカラー×グレーの2色に抑える。製品UIのスクリーンショットは無加工。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

Report a problem with this skill