jinba-consulting-pptx-skill README

The project's README from github.com/carnot-tech/jinba-consulting-pptx-skill. As one markdown file: README.md.

consulting-pptx-skill

AIに「まじ」なPowerPointを作らせるためのClaude Codeスキル。 スライドの設計規約（約110項目）、規約違反を見つける機械チェック、62型のHTMLパーツ集（基本27＋追加35）、型カタログPDFをまとめたものです。資料は HTML（16:9）で組み、Chrome で PDF に書き出します。

進め方は、規約を読む → パーツ集から必要なパーツを取り出して1枚ずつ組む → 機械チェックを通す → 作り方を知らない別のエージェントにレビューさせる、の順です。

A Claude Code skill for generating boardroom-quality decks: a slide-design rulebook, an automated rule checker, a 62-part HTML slide library (16:9, one section per slide, printed to PDF via Chrome), and a visual catalog PDF.

私たちが実際に毎週の提案書・報告書づくりで使っている仕組みの公開版です。解説記事はこちら → AIにまじなスライド作らせる（note）

本質は references/slide-rules.md（約110項目のスライド規約）

このリポジトリでいちばん価値があるのは、実はテンプレでもスクリプトでもなく、slide-rules.md というテキストファイルです。実務の資料レビューで受けた指摘を1行ずつ書き溜めた約110項目。「結論はタイトルに書く」「角丸禁止」「塗りのあるボックスに枠線を付けない」「1資料1用語」「前提・定義は左、帰結は右」…。

使い方は3つだけです。AIに資料を作らせる前に毎回このファイルを読ませる。出力後に scripts/check_deck.py で違反を機械検出する。最後に references/content-review-prompt.md の指示文で、作り方を知らない別のエージェントにデッキを読ませ、日本語・論理・矛盾の指摘を受けて採用分だけ直す。 AIはセッションごとに記憶がリセットされるので、口頭で注意しても定着しません。ルールをファイルにして毎回読ませるのが定着させる方法です。

良いスライドを決めるのは型ではなく、組んだ後の調整です。表を2枚に割る、右カラムを帰結の形に書き直す、タイトルだけを通して読んでストーリーを繋ぎ直す。型に囚われず直し、そこで受けた指摘を slide-rules.md に1行足す。この繰り返しが品質の源で、型カタログとパーツ集は「たたき台を早く出して、調整に時間を回す」ための道具です。

自社で使うときは、slide-rules.md に自社の規約・指摘を追記して育ててください。

62型のスライド型カタログ

入口は assets/SlideCatalog_16x9.pdf（62ページ）です。P.1〜27 が基本パーツ集、P.28〜62 が追加パーツ集を印刷したもので、型ID・型名・使いどころの一覧は references/archetype-catalog.md にあります。

「62型」は作れる見せ方の上限ではありません。実際のデッキでは、型を組み合わせたり崩したりして規約の範囲で自由に組むので、見せ方のパターンはこれより多くなります。型カタログは「レイアウトの発想帳」として使い、合わなければ捨ててください。

パーツ集の使い方

ファイル 中身 使用頻度
templates/freeform_parts_16x9.html（基本パーツ集） 表紙・全体マップ・目次・章扉・矢羽・前提→帰結・軸のある表・主張パネル・評価表・分布図など27パーツ 高い。まずここから
templates/freeform_parts_more_16x9.html（追加パーツ集） エグゼクティブサマリー・積み上げ棒・ブリッジ・散布図・比較表・マトリクス・イシューツリー・ロードマップ・ガントなど35パーツ 低い。基本で足りないとき

どちらも 16:9・1 section = 1スライドの単体HTMLです。scripts/new_deck.py --parts b01,m05,... のようにパーツ番号を並べると、必要なパーツだけを取り出した1本のHTMLができます（2ファイルの見た目の定義は、衝突しないようにスクリプトが結合します）。あとはプレースホルダー（本文 Text 1、項目名 ラベル 1、見出し タイトル 1、数値 00、年 YYYY年、出典 出典：Source 1）を実物に差し替えます。残っていると check_deck.py が FAIL にします。

各 section のタイトル欄には型名だけが入っていて、見本の主張文は置いていません。見本文があると、その文型をなぞった資料になってしまうからです（slide-rules §2.8）。タイトルは必ず自分のストーリーラインから書きます。

色と書体は両ファイルで同じ既定です（暖色系: 生成りの地・濃茶の文字・茶のアクセント。見出しは明朝、本文はゴシック）。各ファイルの <style> 冒頭にある :root の変数で一括管理していて、ネイビー系にする値はコメントで同梱しています。

セットアップ

# 1. Claude Code のスキルフォルダに clone する（これだけで規約・パーツ集・機械チェックが使える）
git clone https://github.com/carnot-tech/consulting-pptx-skill.git ~/.claude/skills/consulting-pptx-skill

# 2.（任意）実レンダリング検査 check_layout.mjs を使う場合。Node.js が必要。playwright と Chromium が入る
cd ~/.claude/skills/consulting-pptx-skill && npm run setup

# 3.（任意）PPTX ファイルを check_deck.py で検査する場合
pip3 install python-pptx

手動で使う場合

python3 scripts/new_deck.py --list                                          # パーツ番号と型名の一覧
python3 scripts/new_deck.py --parts b01,b02,m05,b06,b09,b10 --title "資料名" -o mydeck.html   # たたき台を生成
python3 scripts/check_deck.py mydeck.html           # 規約の機械チェック（FAIL 0 にする）
node scripts/check_layout.mjs mydeck.html           # フッター重なり・はみ出しの実レンダリング検査
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --headless --disable-gpu \
  --no-pdf-header-footer --print-to-pdf=mydeck.pdf mydeck.html

中身

パス 内容
SKILL.md AIへの指示書（スキルの本体）。考え方と手順だけを書き、詳細は references/ に置く
templates/freeform_parts_16x9.html 基本パーツ集（27パーツ・1パーツ=1スライド・16:9）
templates/freeform_parts_more_16x9.html 追加パーツ集（35パーツ。チャート・比較表・マトリクス・計画系）
references/slide-rules.md スライド作成ルール正典（約110項目）
references/archetype-catalog.md 62型の型カタログ（型ID・型名・使いどころ・どのパーツ集の何番か）
references/content-review-prompt.md フレッシュアイ・レビューの指示文。機械チェックのあと、作り方を伏せた別エージェントにデッキのファイルを渡して日本語・論理・破綻を拾わせ、採否表にして直す
references/ai-smell-lexicon.md AI臭ワード・言い回しのリストとセルフチェック
scripts/new_deck.py パーツ番号を並べて1本のデッキHTMLを生成（両パーツ集のCSSをスコープして結合・ページ番号の振り直し）
scripts/check_deck.py 規約の機械チェック（HTML / PPTX 両対応。テンプレ集の検査は --template）。タイトルの「N段階」と本文の連番の食い違いも FAIL にする
scripts/check_layout.mjs HTMLデッキの実レンダリング検査（フッターとの重なり・右端/下端のはみ出し）
assets/SlideCatalog_16x9.pdf 62型のスライド型カタログ（両パーツ集を印刷した62ページ）。型を探すときの入口
assets/SuperTemplate_62type.pptx 62型のPPTX見本帳（全スライド編集可能）。PowerPoint で手動コピーして使うときの見本。パーツ集の正本ではない

カスタマイズ

About

Made by Carnot AI — AIエージェント基盤「Jinba」を開発・提供しています。 このスキルと同じ仕組みを、ブラウザのチャットだけで使える形（Jinba App）でも提供しています。

License

MIT

jinba-consulting-pptx-skill (carnot-tech/jinba-consulting-pptx-skill)

Searching Database…

1.2K ·GitHub
Jinba-consulting-pptx-skill
Что это?Это навык для Claude Code / Codex, заставляющий ИИ собирать презентации «совещательного качества» в стиле PowerPoint: свод правил дизайна слайдов из ~110 пунктов, автоматическая проверка правил, HTML-библиотека слайдов из 62 частей (16:9, один слайд на секцию) и визуальный каталог в PDF.
Это приложение или навык, который читает ИИ?Это навык для Claude Code / Codex: папка с инструкциями (SKILL.md), файлами правил, HTML-шаблонами частей и скриптами на Python/Node, которые агент-кодировщик читает и запускает, а не отдельное приложение.
Как на самом деле собрать презентацию с его помощью?Процесс такой: ИИ читает правила слайдов, берёт нужные части из HTML-библиотек, чтобы собрать презентацию слайд за слайдом, запускает механическую проверку, а затем отдельный агент, не знающий, как она собиралась, просматривает её на предмет логики и формулировок.
Что нужно установить для запуска скриптов?checkdeck.py и newdeck.py работают только на стандартной библиотеке Python; экспорт PDF опирается на headless-печать Chrome; package.json существует лишь для установки Playwright для опциональной проверки рендеринга макетов.
Можно ли получить настоящий файл PowerPoint (.pptx)?Не автоматически — навык собирает HTML-слайды, печатаемые в PDF, и конвертера HTML-to-PPTX в комплекте нет; для настоящего .pptx вы сдаёте PDF или вручную копируете из приложенного SuperTemplate62type.pptx в PowerPoint.
Для кого это сделано?Это публичная версия системы, которую авторы реально используют каждую неделю для подготовки консалтинговых предложений и отчётов.
Что такое slide-rules.md?Текстовый файл примерно из 110 конкретных правил дизайна, собиравшихся по одной строке из реальных разборов презентаций, например «выноси вывод в заголовок» или «никаких скруглённых углов» — ИИ просят прочитать его перед сборкой любого слайда.
Как работает этап проверки свежим взглядом?После прохождения автоматической проверки отдельный ИИ-агент, которому никогда не рассказывали, как собиралась презентация, читает файлы по references/content-review-prompt.md и отмечает проблемы формулировок, логики и противоречий для исправления автором.
Что на самом деле входит в каталог из 62 частей?27 базовых HTML-частей (обложки, карты, повестки, макеты от посылки к выводу, таблицы) плюс 35 дополнительных (executive summary, многослойные столбчатые диаграммы, bridge-диаграммы, диаграммы рассеяния, деревья проблем, роадмапы, диаграммы Ганта), каждая — один слайд 16:9.
Что такое Jinba App?Это продукт браузерного чата от создателя навыка, Carnot AI, предлагающий тот же процесс сборки презентаций без необходимости устанавливать Claude Code или Codex.
What are similar projects?codex-ppt-skill, software-certificate-skill, dashi-ppt-skill, luobo-ppt, xxg-portrait-rebuild-light, handout-remake, cy-carousel-skill, Kami
Which topics is it in?pptx, presentation, codex-skill, claude-code-skill, agent-skill, skill, pdf, anthropic, html, agent-skills, productivity, codex
Creator
carnot-tech
Size
21.4 MB
Stars
1.2K
Updated
CommitOct 14
Age
1mo
Commits · 90 Days