deck-beamer-academic について
学術発表の内容をコンパイル可能な LaTeX Beamer スライドにするスキルです。研究者や教育者向けに、スライド仕様、話者ノート、視覚的なテンポ、再現可能なコンパイル手順を扱います。
主な機能
- 01発表ジャンルに応じた構成
- 02スライドごとの仕様とペース配分
- 03主張を示すスライドタイトル
- 04話者ノートと段階表示
- 05コンパイル可能な Beamer ソース
- 06コンパイルと図の受け渡し手順
活用シーン
- 01学会発表やセミナーのスライド作成
- 02例題を含む講義スライドの作成
- 03発表計画から Beamer ソースへの変換
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ jurgendn/ agent-skills --skill deck-beamer-academicインストール後、Claude Code で/deck-beamer-academicを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
assets/preamble.texevals/evals.jsonreferences/slide-spec-and-design.mdscripts/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/予備資料に記載する必要があります。
出力
- 確定したスライド仕様(Markdown)。
- プレアンブルを含む、コンパイル可能な単一の
.texファイル(プレースホルダーを明確に示すこと)。 - コンパイル、図の配置、ノートの切り替えに関する手順。