OpenCode Presentation Skills

OpenCode 專用的整合型簡報技能集，將 SOIL 教學設計核心與三條輸出路徑整合在同一個 repo：

• 可編輯 PowerPoint：PptxGenJS 原生文字、表格、形狀與圖表
• 互動 HTML：原生 HTML／CSS／JavaScript，支援鍵盤、列印與響應式版面
• Draw 圖片式簡報：draw skill 生成圖片，支援 baked 與 plate 模式

這是 OpenCode 版本，不依賴 Codex Presentations 或 Artifact Tool。

技能地圖

Skill	用途	主要輸出
soil-teaching-deck	SOIL 六引擎總路由與 renderer-neutral YAML	YAML、PPTX、HTML
pptx-teaching-deck	正式可編輯教學／研習／研究簡報	.pptx
html-slide-deck	離線互動、響應式、可列印簡報	index.html
soil-image-deck	SOIL 圖片式簡報與 plate overlay	圖片包、.pptx
yaml-image-deck	固定 YAML 視覺語法與批次圖片頁	圖片包、.pptx

安裝

Windows PowerShell：

git clone https://github.com/mathruffian-dot/opencode-presentation-skills.git
Set-Location opencode-presentation-skills
python install.py
python -m pip install -r requirements.txt
npm install
python scripts/validate_repo.py

install.py 會將五個 skill 複製到：

%USERPROFILE%\.config\opencode\skills\

Level 3 圖片式簡報另需 OpenCode 可載入 draw skill。Draw 是本機技能與金鑰管理邊界， 本 repo 不內含私人 skill、API key 或生成圖片。

使用流程

1. 先判斷簡報目的、受眾、時間、頁數與輸出格式。
2. 使用 soil-teaching-deck 建立 renderer-neutral YAML 核心。
3. 依輸出選擇 pptx-teaching-deck、html-slide-deck 或 soil-image-deck。
4. 若需要 AI 視覺，OpenCode 一律載入 draw skill；預設 low 品質。
5. 產出後執行 YAML、圖片、PPTX 或瀏覽器 QA，再交付完整路徑。

觸發範例

用 SOIL 把這份教材做成 12 頁、給國中生使用的可編輯 PPTX。

把這份課程內容做成可離線開啟、支援鍵盤與列印的互動 HTML 簡報。

用 Draw 做一份圖片式教學簡報，保留可編輯的中文文字與公式。

安全與品質

• 重要文字、數值、公式與圖表標籤保持可編輯，不用整頁截圖冒充 PPTX。
• 圖片式簡報必須保存 prompt、定稿圖片與品質檢查結果。
• 不把 API key、token、個資、學生資料或未授權素材放入公開 repo。
• 產出前先完成規格與必要的使用者確認；產出後逐頁或逐圖檢查。

授權與來源

本整合版以作者既有的 soil-teaching-deck、soil-image-deck、yaml-image-deck、 codex-presentation-skills 公開內容為基礎，整合與 OpenCode 路徑修正見 ATTRIBUTIONS.md。