soil-motion-deck

一次製作，兩份成品：有動畫的教學簡報（.pptx），加上同內容的解說影片（MP4）。

這是一個給 Claude Code（以及 Codex 等讀得懂 SKILL.md 的 agent）用的 skill，把兩個技能接在一起：

• SOIL Teaching Deck：依李俊儀教授的 SOIL 六引擎，把教材做成有教學力的簡報。
• claude-motion-explainer：用 HyperFrames 做配音、字幕、三色主題的原理解說動畫。

動畫只做一次：先做 B，再從 B 的「靜音孿生版」剪出 🎬 頁那幾格，嵌進簡報。兩邊的秒數、用語、顏色完全一致。

範例：〈畢氏定理〉（國中八年級）

簡報 13 頁。第 3 頁是 3-4-5 方格，第 6 頁是拼圖證明，第 9 頁是三個常見錯誤，這三頁是動畫：

影片 110 秒、7 格。下圖是拼圖證明那一段，每個旁白子句截一格：

安裝

先裝好兩個上游技能，再裝這個。每個 repo 都是把資料夾複製到你的 agent 讀取 skills 的地方：

SKILLS=~/.claude/skills        # Codex 改成 ~/.agents/skills
git clone https://github.com/mathruffian-dot/claude-motion-explainer.git
git clone https://github.com/mathruffian-dot/soil-teaching-deck.git
git clone https://github.com/mathruffian-dot/soil-motion-deck.git
cp -r claude-motion-explainer/skills/* "$SKILLS"/
cp -r soil-teaching-deck/skill "$SKILLS"/soil-teaching-deck
cp -r soil-motion-deck/skills/* "$SKILLS"/

接著照 claude-motion-explainer 的 README 裝 HyperFrames 和它的官方 skills（faceless-explainer 等）。

需要：Node.js 22+、ffmpeg、Python 3、HyperFrames、源石黑體（SOIL 技能會自動安裝）。PptxGenJS 3.12.0 由本技能的 templates/package.json 安裝在簡報資料夾裡。檢查投影片版面時，Windows 用 PowerPoint 本身輸出縮圖；其他系統用 LibreOffice + poppler。

沒有 sub-agent 的 agent 也能用：製作動畫的步驟改成一格一格依序做，SKILL.md 有寫。

怎麼用

在 Claude Code 裡直接說：

用 SOIL 幫我做「光合作用」的教學簡報，國中七年級、一節課。關鍵頁做成動畫，另外也要一支解說影片。

Agent 會先問科目、對象、時間、要哪幾份成品和配色，接著照 SOIL 的引擎一～三排好頁面，標出哪幾頁做動畫，給你確認後才開始做。

裡面有什麼

English

An agent skill that joins the SOIL Teaching Deck workflow with claude-motion-explainer: one production yields (A) a teaching .pptx whose key slides embed silent, caption-free animation clips with poster frames, and (B) a narrated, captioned explainer MP4 of the same content. The clips are cut from a silent twin render of the film, so timing matches exactly. Written in Traditional Chinese.

授權

MIT。上游與第三方元件見 NOTICE.md。