mcpField
D
deck-beamer-academic

deck-beamer-academic

github.com/jurgendnドキュメント1156 回インストール6 週間前に更新
リポジトリ

deck-beamer-academic について

学術発表の内容をコンパイル可能な LaTeX Beamer スライドにするスキルです。研究者や教育者向けに、スライド仕様、話者ノート、視覚的なテンポ、再現可能なコンパイル手順を扱います。

主な機能

  1. 01発表ジャンルに応じた構成
  2. 02スライドごとの仕様とペース配分
  3. 03主張を示すスライドタイトル
  4. 04話者ノートと段階表示
  5. 05コンパイル可能な Beamer ソース
  6. 06コンパイルと図の受け渡し手順

活用シーン

  1. 01学会発表やセミナーのスライド作成
  2. 02例題を含む講義スライドの作成
  3. 03発表計画から Beamer ソースへの変換

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jurgendn/agent-skills --skill deck-beamer-academic

インストール後、Claude Code で/deck-beamer-academicを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

assets/
preamble.tex
evals/
evals.json
references/
slide-spec-and-design.md
scripts/
compile.sh

詳細

Beamer 学術スライド

学術講演や講義に使える、コンパイル可能な LaTeX Beamer ソースを生成します。このスキルは レンダリング のステップであり、コンテンツがスライドにどのように収まるか(媒体)を扱います。上流にある次の 2 つの要素は別の場所で扱われるため、前提として与えられるものとします(見当たらない場合は、簡潔な内容をその場で補います)。

  • ナラティブとペース配分(伝えるべき 1 つの要点、話の流れ、時間配分、削る内容)→ research-talk-planner。
  • 内容の考察(手法やアイデアを実際にどう説明するか――それが必要とされる背景、形式化の前の直感、正当化としての数学、根本的なトレードオフ)→ professor-mentor-technical-teaching。

これらは競合せず、レイヤーとして組み合わさります。professor-mentor-technical-teaching は 適切な説明内容 を決め、このスキルは その説明を媒体に合わせて圧縮 します。教授レイヤーは、教育を目的とするスライドの内容(講義の内容、セミナーで扱うアイデアや手法の展開)の源です。スライドデッキの構成ではありません。8 段階の展開を、そのまま情報量の多い 8 枚のスライドに広げてはいけません。その考察をスライドの Message と Notes に取り込み、各フレームで伝える要点を 1 つに絞ります。

講演計画がある場合は、それを読み込んでください。ない場合は、LaTeX を書き始める前に、以下の計画に関する質問を手短に確認してください。


このスキルが扱うジャンル

ジャンル長さ重視する点テーマのデフォルト
学会発表12–20 分1 つの貢献を明快かつ簡潔に伝えるmetropolis またはシンプルな default
セミナー/コロキウム45–60 分理解を深め、詳細を扱う余地を持たせるmetropolis
招待講演/ジョブトーク45–60 分研究プログラム、センス、深さmetropolis、カスタムタイトル
学位論文発表30–45 分研究成果全体への習熟度必要に応じて機関のテーマ
講義50–90 分教育、例題、反復コントラストの強い配色、大きなフォント

講義と講演では目的が異なります。講義では、説得より学習を優先します。セクションの要約、例題、「理解度を確認する」スライド、許容できる程度の重複を盛り込みます。講演では、記憶に残る 1 つのメッセージを優先し、徹底的に内容を絞ります。

ジャンルごとの内容考察レイヤーの活用度:

ジャンルprofessor-mentor-technical-teaching の活用
講義大いに活用します。講義は教えることそのものです。すべての概念を教授モードで考察し(まず直感を示し、例題を使い、批判的に分析する)、その後スライドに分けます。
セミナー/コロキウムアイデアや手法の展開に活用します。手法が必要とされる背景を示し、方程式の前に直感を築き、根本的なトレードオフを明らかにします。
招待講演/ジョブトーク手法のスライドに限って軽く活用します。デッキの役割はセンスと研究プログラムを示すことであり、再導出することではありません。
学会発表講演の流れに沿って、圧縮した洞察を 1 つ示します。批判的分析の全体像はスライドではなく、質疑応答の準備に含めます。
学位論文発表審査委員会が詳しく尋ねる中心的な手法に活用します。詳しい内容は予備スライドに残します。

ワークフロー

1. 入力を集める(手短に)
  • 資料:論文、セクション、結果、または research-talk-planner の計画。
  • ジャンルと正確な持ち時間。
  • 聴衆(サブフィールドの専門家/広範な ML 分野/混成/学生)。
  • テーマやブランディングの制約(機関のテンプレート、色、ロゴなど)。
  • 数学の密度(講演向けに軽めか、証明を重視するセミナーか)。

計画がなく、講演に相応の内容がある場合は、作業を進める前に伝えるべき 1 つの要点を 1 文で示し、おおまかな時間配分を提示してください。話の流れを黙って作り上げず、確認できるように明示してください。

2. スライド仕様を作成する

references/slide-spec-and-design.md をもとに、スライドごとの仕様を作成します(各フレームにつき1ブロック)。ペース配分のデフォルトは約1分につき1枚です。枚数を増やして駆け足で進めるより、枚数を抑えて時間をかけるほうが効果的です。主張を示すタイトルを使ってください。各ビジュアルの出典(論文の図を再利用/新規の TikZ/表/グラフ)を明記してください。

手法/アイデア/概念を扱うスライドでは、また講義全体を通して、内容を圧縮する前に professor-mentor-technical-teaching を使って内容を検討してください。

  • その手法が応える課題を明示し、それをスライドの Message にします。「手法の概要」にはしません。
  • 形式化より直感を先に示します。直感を説明するスライド(または段階的な表示)を数式のスライドより前に置き、記号を使う前に表記を導入します。
  • すべての数式に役割を持たせます。その数式が「何を最適化/制約/近似/トレードオフしているのか」に答えるようにします。スライド上で論旨に寄与しない数式は Notes または予備スライドに移します。
  • 根本的なトレードオフと失敗例を1つ、仕様に含めます(終盤のスライド1枚、または質疑応答の準備用にまとめることが多いです)。手法を万能なものとして紹介してはいけません。
  • 詳細な説明は Notes(発表者が話す内容)に記載し、フレームには要点だけを示します。

LaTeX を出力する前に、仕様をユーザーに確認してください。

3. コンパイル可能な .tex を出力する

承認済みの仕様を Beamer に変換します。要件は次のとおりです。

  • pdflatex/lualatex ですぐにコンパイルできる、完全な自己完結型ドキュメントにします(assets/preamble.tex をベースとして使用します)。
  • 仕様の各ブロックにつき frame を1つ作成し、仕様の title を frametitle に設定します。
  • Build の各段階には \pause またはオーバーレイ指定(\onslide<>、\only<>)を使います。
  • 発表者向けの Notes は \note{...} に記述し(切り替えやすいよう \setbeameroption{show notes} はコメントアウトしておきます)、スライド上には表示しません。
  • 図は明確な \graphicspath とともに \includegraphics で挿入します。まだファイルが用意されていない場合は、プレースホルダーボックス(\fbox/tikz)を使い、% TODO: replace placeholder と明記します。
  • 投影に適したサイズの表にします(\small/\footnotesize、booktabs)。
  • 仕様で指示されている場合は、数式を段階的に表示します。
4. 引き渡し

ユーザーに、コンパイルコマンド、配置する図ファイル、発表者ノートの切り替え場所を伝えます。想定される質疑応答に備えた予備スライドの付録セクションも提案してください。

.tex とともに scripts/compile.sh を用意し、オプションを覚えていなくても1ステップでデッキをビルドできるようにします。

./scripts/compile.sh talk.tex        # latexmk if present, else two pdflatex passes
./scripts/compile.sh -c talk.tex     # compile, then clean aux files
ENGINE=lualatex ./scripts/compile.sh talk.tex

Beamer で重要な点

  • テーマ:デフォルトでは metropolis を使います(すっきりとしたモダンなデザインで、装飾を控えめにできます)。metropolis/pgfplots が利用できない場合は、標準の default と落ち着いた配色テーマを使います。パッケージへの依存関係を明記してください。
  • フォント:投影しても読める大きさにします。デフォルトの小さなブロックテキストは避けてください。metropolis ではこの点が適切に処理されます。講義では基本サイズを大きくします。
  • オーバーレイ:表示順が重要な場合は、要素を \pause で積み重ねるより \onslide/\only を優先します。オーバーレイは見せ方のための演出ではなく、論理の展開(ベースライン → 提案手法)を示すために使います。
  • 図:論文の図を論文掲載時の解像度のまま \includegraphics で挿入してはいけません。スライド用に図を簡略化または再出力する必要がある場合は、仕様に明記します。
  • セクション:セミナーや講義では、\section{} と \tableofcontents[currentsection] による振り返りが有効です。15分のカンファレンストークでは冗長です。
  • タイトルスライド:タイトル、著者、所属、会場と日付を記載します。就職関連の講演や招待講演では、研究ビジョンを一行で示す副題を追加してもかまいません。
  • 締めくくり:要点を再提示する結論のスライドを置き、その後は箇条書きのまとめではなく、「ご質問はありますか?」またはタイトルスライドを表示して質疑応答に移ります。
  • 再現性:図ファイルを配置する以外に手作業で編集しなくても、デッキをコンパイルできるようにします。

テーマ、フォント、数式、booktabs、tikz、ノートの切り替え、主張を示すタイトルのスタイルを備えた、そのまま使えるプリアンブルについては assets/preamble.tex を参照してください。


拒否すべきアンチパターン

  • 文章の段落や論文の要旨を丸ごとフレームに貼り付ける。
  • 1つのフレームに手法全体を詰め込もうとする。
  • 主張を示すタイトルではなく、ラベルだけのタイトル(Results、Method)を使う。
  • 説明上の目的がないアニメーションや画面切り替え。
  • 論文の図をすべて、論文掲載時の解像度のまま変更せずに取り込む。
  • professor-mentor-technical-teaching の8段階の流れを、内容の詰まった8枚のスライドに展開する。この流れは文章向けです。スライドでは、1フレームにつき1つの要点に圧縮し、詳しい内容は Notes/予備資料に記載する必要があります。

出力

  1. 確定したスライド仕様(Markdown)。
  2. プレアンブルを含む、コンパイル可能な単一の .tex ファイル(プレースホルダーを明確に示すこと)。
  3. コンパイル、図の配置、ノートの切り替えに関する手順。

コメント