Academic deck animator

Skill Nero1688/claude-academic-skills/skills/academic-deck-animator

學術簡報動畫引擎:以 slides_content.json 統一規格驅動的雙引擎動態簡報產生器。引擎A html-canvas 產出自包含 HTML 簡報+Canvas 粒子特效(particle-burst、drift-field、network-lines,僅限封面/章節頁);引擎B native-pptx 產出原生 PowerPoint 檔+真正的物件進場動畫(appear/fade/wipe/fly-in,依 entry_order 與 delay_ms 排時序),另有 split 拆頁模式把逐步動畫拆成連續頁面、轉 PDF 排版不重疊。內建學術動畫克制原則(動畫服務論證,不做裝飾)。何時用:口試簡報、研討會報告、演講簡報要加動畫或動態效果、要粒子特效開場、要逐步揭示研究架構/模型/論證、要把動畫簡報轉成 PDF 講義時。觸發詞:PPT動畫、簡報動畫、動態簡報、動效、粒子特效、particle、canvas 簡報、進場動畫、飛入、淡入、逐步顯示、逐條出現、動畫拆頁、slides_content.json、簡報轉場。與 academic-pptx 劃界:那個管簡報「內容與結構」的學術決策(說什麼、怎麼編排),本 skill 管「動效實作」(怎麼動起來);先用那個定內容,再用本 skill 上動畫。與 academic-slides 劃界:那個做 Beamer 風靜態 HTML 主題與數學排版,本 skill 做動畫層與粒子特效;純靜態學術 HTML 簡報找那個。與 pptx 劃界:那個是通用 .pptx 檔案讀寫機制,本 skill 是學術動畫規格+雙引擎產生器。From its SKILL.md

Install

npx -y skills add Nero1688/claude-academic-skills --skill academic-deck-animator

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

5 stars5 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
runs commandsInstructs the agent to run 4 commands, including `python scripts/build_html_deck.py slides_content.json -o deck.html` and 3 more.

SKILL.md

6.6 KB, ~2.3k tokens by cl100k_base, as published. Nobody here has run it

Academic Deck Animator(學術簡報動畫引擎)

把學術簡報從「靜態頁面」升級成「有節奏的論證」。一份 slides_content.json 驅動兩種輸出:

引擎	產出	適用場景
`html-canvas`	自包含 .html(零依賴、瀏覽器直接開)	演講現場用自己電腦、要粒子特效與流暢網頁動效、線上分享連結
`native-pptx`	原生 .pptx(真 PowerPoint 動畫,可再編輯)	主辦方要求交 .pptx、口試現場用別人電腦、需要委員會後修改

兩引擎讀同一份 JSON,可同時輸出兩種格式。

核心哲學:動畫是論證的節拍器,不是裝飾

學術簡報的觀眾(口試委員、審稿人、同行)對「AI 生成感」與「業配感」高度敏感。未經設計的連環動畫是最明顯的破綻。因此本 skill 的預設值全部保守:

動畫唯一的正當理由:控制資訊揭示的節奏,讓聽眾的注意力跟上論證。
粒子特效只允許出現在封面、章節分隔頁、結尾頁——內容頁一律禁用。
結果表格、迴歸係數、統計圖,永不加裝飾性動畫;只允許「逐欄/逐列揭示」這種服務講解的動畫。
每一個動畫都應對應講者的一個「說話節拍」。講稿裡沒有停頓點的地方,就不該有動畫。

完整原則與每種版型的建議,讀 references/animation-principles.md。

工作流程

第 1 步:確認內容已定稿

本 skill 不做內容決策。若使用者的簡報內容還沒定(還在想說什麼、順序怎麼排), 先走 academic-pptx 的內容規劃,拿到定稿大綱後再回來。內容已定就直接進第 2 步。

第 2 步:撰寫 slides_content.json

依 references/slides-content-schema.md 的完整規格撰寫。最小骨架:

{
  "metadata": { "presentation_title": "...", "author": "...", "version": "1.0.0" },
  "global_settings": {
    "aspect_ratio": "16:9",
    "theme_color": { "primary": "#0F172A", "secondary": "#38BDF8", "accent": "#F59E0B" },
    "font_family_east_asian": "Microsoft JhengHei"
  },
  "slides": [
    {
      "slide_id": 1,
      "layout": "cover",
      "engine_config": { "engine": "html-canvas", "fx": "particle-burst", "fx_intensity": "medium" },
      "content": { "headline": "主標題", "sub_headline": "副標題" }
    }
  ]
}

重要欄位速查:

engine_config.engine:html-canvas 或 native-pptx。整份簡報通常選一種;混用時各引擎只輸出屬於自己的頁面。
engine_config.fx:canvas 特效名(particle-burst / drift-field / network-lines / none)。只在 cover、section_divider、closing 版型生效,其他版型會被引擎忽略並警告。
elements[].animation:{ "entry_order": 1, "effect": "fade-in", "duration_ms": 500, "delay_ms": 0, "trigger": "on-click" }。
content.bullets[].animation_step:條列逐步揭示的步驟編號;同編號同步出現。
engine_config.post_process: "split-animation-layers":native-pptx 引擎的拆頁指令,轉 PDF 前用。

第 3 步:執行引擎

引擎 A(HTML-Canvas),零第三方依賴,任何有 Python 的環境都能跑:

python scripts/build_html_deck.py slides_content.json -o deck.html

引擎 B(Native-PPTX),需要 python-pptx(pip install python-pptx):

# 產出含原生動畫的 pptx
python scripts/build_native_pptx.py slides_content.json -o deck.pptx

# 拆頁模式:逐步動畫拆成連續頁面(轉 PDF 用,PPspliT 概念)
python scripts/build_native_pptx.py slides_content.json -o deck_print.pptx --split

第 4 步:驗證與交付

HTML:用瀏覽器打開,←/→ 或空白鍵換頁、換頁內點擊觸發逐步揭示;P 鍵切換簡報者模式(含備忘稿)。
PPTX:先用 python-pptx 重新開啟確認檔案合法,再提醒使用者用 PowerPoint 實際播放一次確認動畫。動畫時序不對時,調 JSON 的 entry_order / delay_ms 重跑即可,不要手動改 pptx。
拆頁版:確認頁數 =「原頁數 + 各頁動畫步數總和」(每頁 K 步拆成 K+1 頁,含未點擊的初始狀態),匯出 PDF 後排版不重疊。

兩引擎的能力邊界(如實告知使用者)

能力	html-canvas	native-pptx
粒子特效	✅ 三種,可調強度	❌(原生 PPT 做不到,勿承諾)
物件進場動畫	✅ CSS 級(fade/fly/wipe/zoom)	✅ 原生(appear/fade/wipe/fly-in)
進場時序(順序+延遲)	✅	✅(entry_order → 點擊組;delay_ms → 組內延遲)
交出去可再編輯	❌(HTML 原始碼)	✅(正常 PowerPoint 物件)
動畫拆頁轉 PDF	不需要(直接列印模式)	✅ `--split`
圖表	建議貼靜態圖(PNG/SVG)	原生 shape 組合或貼圖

native-pptx 的動畫是以 OOXML <p:timing> 時間樹直接注入(python-pptx 沒有動畫 API)。支援的效果清單與對應 presetID 寫死在 scripts/build_native_pptx.py 的 EFFECT_MAP, 新增效果前先讀該檔案開頭的註解,不要憑記憶編 presetID。

環境備註

兩支腳本都相容 Claude Code(桌面版)與 claude.ai 網頁版的程式執行環境;引擎 A 只用標準函式庫。
Windows 中文字型預設「微軟正黑體」,可在 global_settings.font_family_east_asian 覆寫(如 DFKai-SB 標楷體)。
產出檔案一律 UTF-8;JSON 內中文不需轉義。

What ships with it: 6 files

58.5 KB alongside SKILL.md, 3 of them executable