Communitygithub.com

PPTXの作成・編集・分析

このスキルは、.pptxまたは.potxファイルが入力、出力、またはその両方として関わるあらゆる場面で使用します。デッキ、スライド、プレゼンテーションの作成、既存プレゼンテーションの読み取り・解析・編集、テンプレートの操作、スライドの結合・分割、スピーカーノートやコメントの操作など、あらゆるPowerPoint関連タスクをサポートします。

PPTXの作成・編集・分析 とは?

このスキルは、PowerPointプレゼンテーション(.pptx)およびテンプレート(.potx)ファイルの作成、編集、分析を専門に行います。`pptxgenjs`ライブラリを用いた新しいデッキの作成、ZIPアーカイブとしてのXML直接編集による既存デッキの変更、`markitdown`や`thumbnail.py`スクリプトによるコンテンツの読み取りを可能にします。特に`pptxgenjs`には多くの注意点があり、スキルのドキュメントではレイアウト設定、カラー指定、リスト、チャート、アイコンなどに関する主要な落とし穴を詳細に解説しています。また、テンプレートを使用する場合は、`add_slide.py`や`clean.py`などのスクリプトを使用した構造編集ワークフローを推奨し、デッキの検証には`validate.py`を使用します。デザイン面では、トピックに合わせたカラーパレットの選択、視覚的モチーフの採用、安全なフォントの使用(Arial、Calibriなど)を推奨し、ユーザーが指定したフォントがQAで信頼できない場合の注意点も示しています。このスキルはClaude CodeやCodex、Cursor、GitHub Copilotなど、ファイルシステムアクセスとスクリプト実行が可能なAIエージェントで使用できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LiChangZheng10086/doyin_ai_video/tree/HEAD/.agents/skills/pptx

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

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

ドキュメント

PPTXの作成、編集、分析

.pptxはXMLファイルのZIPアーカイブです。タスクに応じてアプローチを選択してください:

タスクアプローチ
新しいデッキの作成pptxgenjsスクリプトを作成します — 以下の注意点を参照
既存デッキの編集、テンプレートからの構築解凍 → ppt/slides/slideN.xmlを編集 → 圧縮
コンテンツの読み取りmarkitdown deck.pptx(各スライドは<!-- Slide number: N -->マーカーで区切られます); 視覚グリッド: python scripts/thumbnail.py deck.pptx

スクリプト

パスはこのスキルのディレクトリからの相対パスです。それ以外はプレーンなPython、Node、またはシェルです。

スクリプト機能
scripts/thumbnail.py deck.pptx [prefix]すべてのスライドのラベル付きグリッドを作成し、テンプレートレイアウトを選択するために使用します。.pptxのみ対応。prefixを指定します(デフォルトはthumbnailsで、同じディレクトリ内の他のデッキのグリッドを上書きします)
scripts/add_slide.py unpacked/ slide2.xml [--after slideN.xml]スライド(またはslideLayoutN.xml)を複製し、パッケージのブックキーピングをすべて行います。-o out.pptxオプションで.pptxファイルを直接受け取ることもできます
scripts/clean.py unpacked/参照されなくなったスライド、メディア、relsを削除します。<p:sldIdLst>が最終確定した後に実行してください
scripts/office/validate.py deck.pptx [--original src.pptx]スキーマ、リレーションシップ、コンテンツタイプ、チャート、スライドのチェックを行い、各障害に対してその修正方法を表示します。テンプレートから派生したデッキには--originalを指定します — テンプレートのスキーマチェックをベースライン化するため、テンプレート自身のXSDエラーがあなたのエラーとして表示されなくなります
scripts/office/soffice.py --headless --convert-to pdf deck.pptxLibreOfficeラッパー — プレーンなsofficeはこのサンドボックスでハングします

pptxgenjsを使用した作成 — 注意点

pptxgenjsはプリインストールされています — npm installを最初に実行せず、スクリプトを作成してrequire('pptxgenjs')を直接使用してください。そのrequireが失敗した場合のみ、npm install pptxgenjsを実行します。モデルはAPIを認識していますが、以下が落とし穴です:

  • スライドを追加する前にpres.layoutを設定してください。 デフォルトのキャンバスはLAYOUT_16x9 = 10" × 5.625" であり、13.3"幅ではありません。端を超える座標は書き込まれてもクランプされず、形状は単にスライド上に表示されません。(LAYOUT_WIDEは13.3" × 7.5"です。)
  • 16進数カラー:#は使用せず、8桁にもしないでください。 color: "FF0000"と指定します。"#FF0000"と、16進数にアルファ値を含めること("00000020")は、どちらもファイルを破損させます。半透明には、塗りつぶしと画像にはtransparency: 0-100、影にはopacity: 0.0-1.0を使用します — それぞれ相手側では静かに無視されます。
  • pptxgenjsはオプションオブジェクトをその場で変更します(最初の使用時に値をEMUに変換します)。2回以上のadd*呼び出しで1つのshadow/optionsオブジェクトを共有しないでください — 毎回新しいオブジェクトを作成してください。
  • 影のoffsetは0以上である必要があります — 負のオフセットはファイルを破損させます。上向きの影を投影するには、正のオフセットでangle: 270を使用してください。
  • letterSpacingは静かに無視されます — 実際のオプションはcharSpacingです。
  • リスト: 各項目にbullet: trueを設定し、リテラルの•は使用しないでください(二重の箇条書きになります)。最後の項目を除くすべての配列項目にbreakLine: trueを設定します。箇条書きの段落間のスペースはparaSpaceAfterで設定し、lineSpacingは使用しないでください(大きなギャップができます)。
  • 出力ファイルごとに1つのnew pptxgen() — インスタンスを再利用しないでください。
  • rectRadiusはROUNDED_RECTANGLEでのみ機能し、RECTANGLEでは機能しません。
  • グラデーション塗りつぶしはサポートされていません — 代わりにグラデーション画像を背景として使用してください。
  • テキストボックスには内部パディングが組み込まれています — テキストを同じxの図形、線、またはアイコンに合わせる必要がある場合は、margin: 0を設定してください。
  • スピーカーノートはslide.addNotes("...")(プレーンテキスト、スライドごとに1回)に記述し、スライド上のテキストボックスには記述しないでください。
  • チャートはネイティブに保ってください。 PowerPointでチャート化できるすべてのものにはaddChart()を使用します(コンボの場合は{type, data, options}の配列を渡します)。ライブラリが公開していないPowerPointネイティブ機能(トレンドライン、エラーバー)については、自分で追加の系列を計算するか、生成されたOOXMLを後処理してください — レンダリングされた画像にフォールバックしないでください。PowerPointにネイティブフォームがないチャートタイプ(Sankey、ネットワーク、コード)のみ画像として配置します。
  • デフォルトのチャートは裸でレンダリングされます — タイトルなし、データラベルなし、時代遅れのパレットです。showTitle + title、showValue: true + dataLabelPosition、chartColors: [...](あなたのパレットから)、フレームを静かにする(catAxisLabelColor/valAxisLabelColor、valGridLine: { color, size }、catGridLine: { style: "none" }、単一系列の場合はshowLegend: false)を設定してください。
  • 積み上げ棒グラフまたは縦棒グラフでは、dataLabelPositionはctr、inEnd、またはinBaseでなければなりません。 outEndはファイルを破損させます。
  • secondaryValAxis/secondaryCatAxisを使用するコンボ系列は、チャートオプションにvalAxesとcatAxesの両方を、それぞれ2エントリずつ必要とします。 これらがないと、pptxgenjsは宣言しない軸IDを書き込み、PowerPointはそのチャートを破棄し、ファイルを破損として報告します。valAxesのみを提供するだけでは不十分です。
  • writeFile()の後、python scripts/office/validate.py deck.pptxを実行してください。 上記の2つのチャート障害と、PowerPointが拒否するスライドXMLの欠陥を報告し、それぞれの修正方法を示します。生成プログラム内で修正し、パッケージ化されたXMLを手動編集しないでください。
  • <p:presentation>の子要素を並べ替えないでください。 pptxgenjsは<p:sldIdLst>の直後に<p:notesMasterIdLst>を書き込み、両方のマスターを1つのテーマ部分にポイントします。PowerPointはそれを問題なく読み取りますが、その要素を移動すると、同じデッキが開けなくなります。
  • アイコン: react-iconsをSVGにレンダリングし(ReactDOMServer.renderToStaticMarkup)、sharpで≥256pxにラスタライズし、addImage({ data: "image/png;base64," + buf.toString("base64") })で挿入します — image/png;base64,プレフィックスは必須です(react-icons、react、react-dom、sharpはプリインストールされています — requireが失敗した場合のみnpm install react-icons react react-dom sharpを実行します)。

既存のデッキとテンプレートの編集

最初にレイアウトを選択します:python scripts/thumbnail.py template.pptx template-thumbsは、すべてのスライドのラベル付きグリッドを作成し、作成したファイルを表示します — template-thumbs.jpgを、12スライドを超えるとtemplate-thumbs-N.jpgに分割します。常にその2番目の引数(デッキにちなんだ名前)を渡してください。 デフォルトはthumbnailsなので、同じディレクトリで2つのデッキのサムネイルを作成すると、互いのグリッドを静かに上書きします — 最初のデッキのものは単純に失われます(テンプレート解析のみ — 視覚的なQAには画像への変換からのフル解像度レンダリングが必要です;.pptxのみを受け付けるので、最初に.potxを.pptx名にコピーしてから使用してください)。markitdownと組み合わせて、各コンテンツセクションをテンプレートスライドにマッピングし、レイアウトを変化させてください — すべてのセクションを同じタイトルと箇条書きのスライドに配置しないでください。

python3 -c "import sys,zipfile; zipfile.ZipFile(sys.argv[1]).extractall('unpacked')" deck.pptx
python scripts/add_slide.py unpacked/ slide2.xml --after slide2.xml   # スライド(またはslideLayoutN.xml)を複製します;新しいスライドのパスを表示します
# スライドの並び替え/削除 = ppt/presentation.xml の <p:sldIdLst> を編集します
python scripts/clean.py unpacked/                                     # 削除後:孤立したスライド、メディア、relsを削除します
# ppt/slides/slideN.xml でスライドコンテンツを編集します
(cd unpacked && rm -f ../out.pptx && zip -Xr ../out.pptx .)           # ディレクトリ内部から圧縮します;最初にrmしないと、削除された部分が残ります
python scripts/office/validate.py out.pptx --original deck.pptx
  • すべての構造的な作業(追加、削除、並び替え)は、スライドのコンテンツを編集する前に行ってください。 add_slide.pyはスライドファイルをそのままコピーするため、編集後に複製すると編集済みのコンテンツがクローンされます。また、clean.pyは<p:sldIdLst>に存在しないスライドを削除します。これには書き込んだばかりのスライドも含まれます。
  • スライドファイルを手動でコピーしないでください — add_slide.pyは、新しいスライドに必要なすべての登録を行い、作成したものを報告します(Created ppt/slides/slide17.xml from slide2.xml)。ファイルに対して直接動作することもできます:add_slide.py deck.pptx slide2.xml -o out.pptx — -oを渡してください。渡さないと、入力デッキをその場で上書きします。 複製されたスライドは、そのソースのチャート/SmartArt/埋め込みオブジェクト部分を複製せずに参照するため、一方のスライドのチャートを編集すると、もう一方のスライドのチャートも変更されます。
  • python-pptxを使用する場合、次の3つのことはできません:スライドの複製(エントリポイントはadd_slide(layout)のみ)、text_frame.text = "..."による書式の保持(段落をスタイルのない単一のランに折りたたみます — 代わりにrun.textを割り当ててください)、ほとんどのテンプレートアートで使用されるSVG/EMFの読み取り(add_pictureはUnidentifiedImageErrorを発生させます)。
  • レガシーな.pptは最初に変換する必要があります:python scripts/office/soffice.py --headless --convert-to pptx file.ppt。.potxテンプレートは、解凍と圧縮が同じように機能します — 出力の拡張子は.potxのままにしてください。
  • テンプレートのアイコンや画像を再利用するには、それを既に含むスライドまたはレイアウトを複製してください。

テンプレートを埋めるとき:

  • XML変換をスクリプト化する場合は、defusedxml.minidomでパースしてください — xml.etree.ElementTreeを介してOOXMLをラウンドトリップすると、名前空間プレフィックスが書き換えられ、デッキが破損します。
  • テンプレートのスロット ≠ ソースアイテム。 テンプレートに4人のチームメンバーが表示されていて、あなたが3人しかいない場合は、4人目のメンバー全体のグループ(画像+テキストボックス)を削除し、テキストだけを削除しないでください — その後、QAで孤立したビジュアルがないか確認してください。
  • リスト項目ごとに1つの<a:p> — 複数の項目を単一の段落に連結しないでください。間隔を維持するために兄弟の<a:pPr>をコピーし、タイトル、セクションヘッダー、インラベルの(Status:, Owner:)には<a:rPr>にb="1"を設定してください。
  • 箇条書きはレイアウトから継承させ、オーバーライドする場合にのみ<a:buChar>、<a:buAutoNum>(番号付き)、または<a:buNone>を追加してください — テキスト内にリテラルの•を決して使用しないでください。
  • 先頭または末尾にスペースがあるテキストは、その<a:t>にxml:space="preserve"が必要です。

デザインのアイデア

退屈なスライドを作成しないでください。 白い背景にプレーンな箇条書きは誰も感心させません。各スライドに、このリストからのアイデアを検討してください。

開始前

  • 大胆で、コンテンツに基づいたカラーパレットを選んでください:パレットは、このトピックのためにデザインされたように感じられるべきです。あなたの色を完全に異なるプレゼンテーションに交換しても「機能する」場合、あなたは十分に具体的な選択をしていません。
  • 平等よりも支配:1色が支配的(60-70%の視覚的重み)で、1-2の補助トーンと1つのシャープなアクセントを持つべきです。すべての色に均等な重みを与えないでください。
  • ダーク/ライトのコントラスト:タイトルスライドと結論スライドには暗い背景、コンテンツスライドには明るい背景(「サンドイッチ」構造)。または、プレミアムな雰囲気のために全体を暗くすることもできます。
  • 視覚的モチーフにコミットする:1つの特徴的な要素を選び、それを繰り返します — 丸みを帯びた画像フレーム、色付きの円の中のアイコン。それをすべてのスライドで実行します。モチーフとしてカラーバーやアクセントストライプを使用しないでください(避けるべきリストを参照)。

カラーパレット

トピックに合った色を選んでください — デフォルトの青にしないでください。これらのパレットをインスピレーションとして使用してください:

テーマプライマリセカンダリアクセント
ミッドナイトエグゼクティブ1E2761 (ネイビー)CADCFC (アイスブルー)FFFFFF (ホワイト)
フォレスト&モス2C5F2D (フォレスト)97BC62 (モス)F5F5F5 (クリーム)
コーラルエナジーF96167 (コーラル)F9E795 (ゴールド)2F3C7E (ネイビー)
ウォームテラコッタB85042 (テラコッタ)E7E8D1 (サンド)A7BEAE (セージ)
オーシャングラデーション065A82 (ディープブルー)1C7293 (ティール)21295C (ミッドナイト)
チャコールミニマル36454F (チャコール)F2F2F2 (オフホワイト)212121 (ブラック)
ティールトラスト028090 (ティール)00A896 (シーフォーム)02C39A (ミント)
ベリー&クリーム6D2E46 (ベリー)A26769 (ダスティローズ)ECE2D0 (クリーム)
セージカーム84B59F (セージ)69A297 (ユーカリ)50808E (スレート)
チェリーボールド990011 (チェリー)FCF6F5 (オフホワイト)2F3C7E (ネイビー)

各スライドについて

すべてのスライドには視覚的要素が必要です — 画像、チャート、アイコン、または図形。テキストのみのスライドは記憶に残りません。

レイアウトオプション:

  • 2カラム(テキスト左、イラスト右)
  • アイコン+テキスト行(色付きの円の中のアイコン、太字ヘッダー、下に説明)
  • 2x2または2x3グリッド(片側に画像、反対側にコンテンツブロックのグリッド)
  • ハーフブリード画像(左または右側全体)とコンテンツのオーバーレイ

データ表示:

  • 大きな統計呼び出し(60-72ptの大きな数字と下に小さなラベル)
  • 比較カラム(before/after、長所/短所、並列オプション)
  • タイムラインまたはプロセスフロー(番号付きステップ、矢印)

視覚的な仕上げ:

  • セクションヘッダーの横にある小さな色付きの円の中のアイコン
  • 主要な統計やタグラインのためのイタリックのアクセントテキスト

タイポグラフィ

.pptxに書き込むフォント名は、この環境ではなく、ユーザーのPowerPointでレンダリングされます。 視覚的なQAはLibreOfficeを介してレンダリングされ、LibreOfficeは持っていないフォントを代替します — そして一部のフォントでは代替フォントの幅が異なるため、QAプレビューでは実際のデッキにはないテキストオーバーフロー(または収まり)が表示される可能性があります。QAを信頼できるものにするため:

  • 安全なフォント(QAで正しい幅でレンダリングされ、Officeに同梱される):Arial、Calibri、Cambria、Times New Roman、Courier New、Bookman Old Style、Century Schoolbook。本文や収まりが重要なものにはこれらを使用してください。
  • QAリスクゼロで個性のあるヘッダー:安全なリストのセリフヘッダー(Cambria、Bookman Old Style、Century Schoolbook)と安全なリストのサンズ本文(CalibriまたはArial)を組み合わせます。オーバーフローチェックの信頼性を犠牲にせずに視覚的なコントラストを得られます。
  • ユーザーが安全なリスト外のフォントを要求した場合(例:GeorgiaやTrebuchet MS):ユーザーが要求した場所でそれを使用しますが、それらのコンテナには余分な余裕(約10%)を持たせ、それらの要素のQAテキスト収まりを信頼しないでください — そのフォントのプレビューは近似値です。ユーザーが指定していない場合は、本文には安全なリストのフォントを優先してください。
  • QAで信頼できないフォント(代替フォントの幅が異なり、オーバーフローチェックが間違っている可能性があります):Georgia、Trebuchet MS、Impact、Arial Black、Garamond、Consolas、Palatino Linotype。Calibri Lightの代替は環境によって異なります。QAで信頼できないものとして扱ってください。タイトルやアクセントには余裕を持って使用できますが、これらのQAテキスト収まりは信頼しないでください。
  • デフォルトでAptosを使用しないでください — Officeの2023年以降のデフォルトには、ここで互換性のあるメトリックの代替がなく、古いOfficeインストールには存在しないため、両端で信頼できません。
要素サイズ
スライドタイトル36-44pt 太字
セクションヘッダー20-24pt 太字
本文14-16pt
キャプション10-12pt ミュート

…

[truncated for translation]

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

LiChangZheng10086/doyin_ai_video

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.

LiChangZheng10086/doyin_ai_video

Reference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIR...

LiChangZheng10086/doyin_ai_video

Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.

LiChangZheng10086/doyin_ai_video

Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.

LiChangZheng10086/doyin_ai_video

Grill me about specs for the workflows I want to build, within this workspace.

LiChangZheng10086/doyin_ai_video

Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.

LiChangZheng10086/doyin_ai_video

智能 PPT 生成器。支持 7 种视觉风格(乐高/波普/黏土/黑白/商务/学术/科技),具备根据内容自动推荐风格、生成大纲、绘制配图并组装成片的全自动能力。

LiChangZheng10086/doyin_ai_video

Diagnose and fix React codebase health issues. Use when reviewing React code, fixing performance problems, auditing security, or improving code quality.

LiChangZheng10086/doyin_ai_video

Sentry error monitoring and performance tracing patterns for Next.js applications.

LiChangZheng10086/doyin_ai_video

Simplify and refine recently modified code for clarity and consistency. Use after writing code to improve readability without changing functionality.

LiChangZheng10086/doyin_ai_video

✅ "你知道今天所有大模型能读懂你的话,全靠一个叫Transformer的架构吗?"

LiChangZheng10086/doyin_ai_video

Use this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like \"the xlsx in my downloads\") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.

関連スキル