
soil-motion-deck
SOIL 教學簡報 × 解說動畫:一次製作,產出關鍵頁嵌入動畫的 .pptx 與同內容的配音字幕解說影片(Claude Code skill)
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up soil-motion-deck (git-clone project) into my current project. Found on https://claudeers.com/soil-motion-deck Repo: https://github.com/mathruffian-dot/soil-motion-deck Homepage/docs: — Detected install method: git-clone → git clone https://github.com/mathruffian-dot/soil-motion-deck Category: skills. Platforms: cli. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: active; community-verified: false. Confirm the source before running anything.
git clone https://github.com/mathruffian-dot/soil-motion-deck
// compatibility
| Platforms | cli |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | MIT |
| Pricing | open-source |
| Language | JavaScript |
soil-motion-deck
一次製作,兩份成品:有動畫的教學簡報(.pptx),加上同內容的解說影片(MP4)。
這是一個給 Claude Code(以及 Codex 等讀得懂 SKILL.md 的 agent)用的 skill,把兩個技能接在一起:
- SOIL Teaching Deck:依李俊儀教授的 SOIL 六引擎,把教材做成有教學力的簡報。
- claude-motion-explainer:用 HyperFrames 做配音、字幕、三色主題的原理解說動畫。
| 成品 | 內容 |
|---|---|
| A 簡報 | SOIL 簡報,2–4 個 🎬 動畫頁嵌入動畫片段。片段靜音、沒有字幕,老師邊播邊講;沒播放時,畫面停在動畫的結論 |
| B 影片 | 同一份內容的完整解說片(配音 + 字幕),給學生預習、補課 |
動畫只做一次:先做 B,再從 B 的「靜音孿生版」剪出 🎬 頁那幾格,嵌進簡報。兩邊的秒數、用語、顏色完全一致。
範例:〈畢氏定理〉(國中八年級)
簡報 13 頁。第 3 頁是 3-4-5 方格,第 6 頁是拼圖證明,第 9 頁是三個常見錯誤,這三頁是動畫:

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

安裝
先裝好兩個上游技能,再裝這個。每個 repo 都是把資料夾複製到你的 agent 讀取 skills 的地方:
| Agent | skills 資料夾 |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.agents/skills/ |
| 其他 | 該 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 的引擎一~三排好頁面,標出哪幾頁做動畫,給你確認後才開始做。
裡面有什麼
| 檔案 | 用途 |
|---|---|
SKILL.md | 完整流程:訪談 → SOIL 引擎一~三(標出 🎬 頁)→ 影片 → 剪片段 → SOIL 引擎四~六 → 審查 → 交付 |
scripts/make_silent.py | 複製影片專案,拿掉旁白和字幕,做成「靜音孿生版」 |
scripts/cut_clips.py | 讀每一格的時間,自動剪出每個 🎬 頁的片段,避開和前後格重疊的轉場,另外輸出封面 PNG |
scripts/thumbs.py、export_thumbs.ps1 | 把每頁投影片輸出成 PNG,再拼成總覽圖(Windows 用 PowerPoint,其他系統用 LibreOffice) |
templates/package.json | 簡報資料夾用的 Node 設定(CommonJS + PptxGenJS 3.12.0) |
templates/deck_helpers.js | PptxGenJS 的共用元件:深色/淺色頁、角色徽章、標題、卡片、動畫播放視窗 |
templates/example_pythagoras.js | 〈畢氏定理〉13 頁的完整範例 |
references/lessons.md | 第一次實作踩過的坑 |
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.
授權
// faq
What is soil-motion-deck?
SOIL 教學簡報 × 解說動畫:一次製作,產出關鍵頁嵌入動畫的 .pptx 與同內容的配音字幕解說影片(Claude Code skill). It is open-source on GitHub.
Is soil-motion-deck free to use?
soil-motion-deck is open-source under the MIT license, so it is free to use.
What category does soil-motion-deck belong to?
soil-motion-deck is listed under skills in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/soil-motion-deck)
// retro hit counter
[](https://claudeers.com/soil-motion-deck)
// reviews
// guestbook
// related in Claude Skills
An agentic skills framework & software development methodology that works.
AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…
💫 Toolkit to help you get started with Spec-Driven Development