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 skill，让 AI 构建会议室级别的 PowerPoint 风格演示文稿：包含约 110 条的幻灯片设计规则手册、一个自动化规则检查器、一个 62 部件的 HTML 幻灯片库（16:9，每个 section 一张幻灯片），以及一份可视化目录 PDF。
这是应用，还是供 AI 读取的 skill？它是一个 Claude Code / Codex skill：一个由说明文件（SKILL.md）、规则文件、HTML 部件模板和 Python/Node 脚本组成的文件夹，由编码智能体读取并运行，不是独立应用。
实际怎么用它做一套幻灯片？流程是：让 AI 读取幻灯片规则，从 HTML 部件库中取出所需部件逐页搭建演示文稿，运行机械化检查器，然后由另一个不知晓制作过程的独立智能体审查逻辑和措辞。
运行脚本需要安装什么？checkdeck.py 和 newdeck.py 只依赖 Python 标准库即可运行；PDF 导出依靠 Chrome 的无头打印；package.json 的存在只是为了安装 Playwright，用于可选的布局渲染检查。
我能从中得到真正的 PowerPoint（.pptx）文件吗？不能自动得到——这个 skill 构建的是打印为 PDF 的 HTML 幻灯片，没有附带 HTML 转 PPTX 的转换器；要真正的 .pptx，你可以交付 PDF，或者在 PowerPoint 里从自带的 SuperTemplate62type.pptx 手动复制。
它是为谁打造的？它是作者每周实际用来制作咨询风格提案和报告的系统对外公开的版本。
slide-rules.md 是什么？一个包含约 110 条具体设计规则的文本文件，每一条都来自真实的幻灯片评审，例如“把结论放进标题”或“不要圆角”——AI 在制作任何幻灯片之前都会被要求先读它。
新鲜视角审查这一步是怎么进行的？在自动化检查器通过之后，一个从未被告知演示文稿制作方式的独立 AI 智能体按照 references/content-review-prompt.md 读取文件，标出措辞、逻辑和自相矛盾的问题，供作者修复。
62 部件的幻灯片目录里到底有什么？27 个基础 HTML 部件（封面、地图、议程、从前提到结论的版式、表格），外加 35 个扩展部件（执行摘要、堆叠柱状图、桥接图、散点图、议题树、路线图、甘特图），每个都是单独的 16:9 幻灯片。
Jinba App 是什么？它是这个 skill 的制作者 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 18
Age
1mo
Commits · 90 Days