marp-slide

marp-slide skill 概覽

marp-slide 能做什麼

marp-slide skill 能協助代理把零散、粗略的簡報需求，整理成完成度高的 Marp 投影片 deck。它內建可直接套用的主題、投影片結構指引，以及 Marp 專用語法參考，重點不是只回你一個泛泛的「幫我寫投影片」，而是更快產出可實際使用的 slide markdown。

誰適合使用 marp-slide

如果你符合以下情況，適合用 marp-slide：

• 會把筆記、大綱或會議內容整理成簡報
• 想要的是相容 Marp 的 markdown，而不是只能在 PowerPoint 用的輸出
• 希望畫面更一致，但不想自己手刻 CSS
• 常常會請代理「做得好看一點」，而且希望這種要求能落在一套具體流程上

最適合解決的工作是什麼

真正的工作不是「產生幾個 bullet points」，而是：挑對主題、把投影片結構排得適合簡報呈現，並產出接近可直接 render 的 Marp markdown。這在你需要快速從想法走到 deck、又不想自己花時間研究 Marp 語法、圖片版型和主題樣式時，特別有價值。

marp-slide skill 跟一般提示詞有什麼不同

和普通 prompt 相比，marp-slide 提供的是：

• 7 種內建視覺方向：default、minimal、colorful、dark、gradient、tech、business
• 可直接重用的 assets/ 模板檔
• 涵蓋 Marp 語法、圖片排版、主題挑選、進階功能與 CSS 自訂的參考文件
• 一套對模糊需求也有明確處理方式的工作流，例如「做得專業一點」或「做得酷一點」

安裝前多數人最在意什麼

決定要不要採用，通常就是看這幾個問題：

• 它真的比從零下 prompt 更省時間嗎？如果你要的是 Marp 輸出，通常會。
• 彈性夠嗎？在主題選擇和 deck 初稿上很夠；但如果你要非常客製化的品牌設計系統，就沒那麼適合。
• 新手好上手嗎？大致上是，因為模板和參考文件能明顯降低 Marp 的摸索成本。
• 任何簡報格式都適用嗎？不是。它最強的情境，還是你的目標格式本來就是 Marp markdown。

如何使用 marp-slide skill

marp-slide 的安裝情境

如果你的代理環境支援 Skills 安裝，常見工具鏈用法是：

npx skills add softaworks/agent-toolkit --skill marp-slide

如果你的環境不是走這個安裝方式，就直接打開 repo 裡的 skills/marp-slide 資料夾，把其中檔案當作工作參考即可。重點是：當代理能同時讀到 SKILL.md、assets/ 和 references/ 裡的內容時，marp-slide 才最能發揮效果。

先讀這些檔案

想最快上手，建議依照這個順序讀：

1. SKILL.md
2. references/marp-syntax.md
3. references/theme-selection.md
4. 依你的情境挑對應的 assets/template-*.md
5. 如果視覺呈現很重要，再讀 references/image-patterns.md
6. 如果需要自訂，再讀 references/advanced-features.md 和 references/theme-css-guide.md

這條閱讀路徑能讓你在最少翻 repo 的前提下，拿到最多有效資訊。

marp-slide 需要什麼輸入

marp-slide 在你提供以下資訊時效果最好：

• 受眾：高階主管、學生、工程師、客戶
• 目標：說服、說明、教學、狀態更新
• deck 長度：目標投影片數或時間限制
• 來源素材：筆記、條列重點、文件片段、會議摘要
• 語氣：正式、技術性、極簡、有活力
• 視覺偏好：主題、light/dark、圖片多或文字少
• 輸出限制：純 Marp markdown，是否需要 speaker notes

如果你只說「幫我做一份簡報」，skill 還是能先起草，但主題選擇和每頁資訊密度就只能靠猜。

怎麼把模糊需求變成高品質的 marp-slide prompt

弱的 prompt：

• 「Create slides about our API migration.」

較強的 prompt：

• 「Use marp-slide to create a 10-slide Marp deck for engineering managers about our API migration. Audience knows the old system but not the rollout plan. Use the tech theme, keep slides concise, include one architecture slide, one risk slide, and one migration timeline slide. Optimize for a 12-minute internal presentation.」

這種寫法能給 skill 足夠的上下文，讓它把結構、密度和主題選對。

真的會影響成果的主題選擇

主題的決策，對可讀性和適配度的影響，通常比多數人想像的大：

• tech：工程、產品架構、開發者分享
• business：季報、提案、對客或內部報告
• minimal：學術、工作坊、文件風格 deck
• colorful 或 gradient：活動、創意、宣傳、較輕鬆的語氣
• dark：暗場簡報，或你想要更強視覺對比時
• default：當需求很廣、還不確定方向時的安全選擇

如果你不太在意風格語言，優先依受眾選，不要只照個人喜好挑。

從模板開始，不要從空白 deck 起手

一個實用的 marp-slide 工作方式，是先打開 assets/ 裡最接近的模板再改：

• assets/template-business.md
• assets/template-tech.md
• assets/template-minimal.md
• assets/template-dark.md
• assets/template-colorful.md
• assets/template-gradient.md
• assets/template-basic.md

這會比叫代理從零發明格式更好，因為這些模板本身就已經內含版面、字體和留白的設計決策。

實際做簡報時建議的 workflow

一個穩定可靠的使用流程是：

1. 先選主題
2. 萃取核心訊息與受眾
3. 先擬投影片大綱
4. 再把每頁展開成 Marp markdown
5. 只有在能幫助理解時才加入圖片或圖表
6. render 後再刪修文字過多的頁面
7. 只有在 deck 的結構已經成立時，才進一步調 CSS

這個順序能避開一個常見失敗模式：邏輯還沒整理好，就先花時間修視覺樣式。

這些技巧會明顯提升 deck 品質

想讓 marp-slide 輸出更好，可以這樣做：

• 如果需求很亂，先要求它產出 slide outline，再做全文內容
• 如果你想要的是能拿來講的 deck，明確指定「每頁最多 3–5 個 bullets」
• 告訴代理哪些頁要偏視覺，不要只說要有文字
• 如果你需要 title slide 和 closing slide，請直接講明
• 提供演講時間；這會大幅影響投影片數量和資訊密度

這些輸入對初稿品質的幫助，通常比空泛地說「專業一點」更大。

什麼時候該看 Marp 參考文件

這些 references 不只是背景資料，而是專門用來解決常見卡點：

• references/marp-syntax.md：基本寫法與 directives
• references/image-patterns.md：圖片擺放與官方 Marpit pattern
• references/best-practices.md：投影片資訊密度與結構
• references/advanced-features.md：更豐富的版型與效果
• references/theme-css-guide.md：自訂 CSS 修改
• references/official-themes.md：更完整的 Marp 主題脈絡

如果你要的是能乾淨 render 的輸出，而不只是純文字看起來順，這些檔案就該派上用場。

marp-slide 使用範例 prompt

你可以用類似這樣的 prompt 呼叫 skill：

「Use marp-slide to create a Marp deck from these notes. Audience: startup investors. Goal: explain product traction and funding use. Length: 8 slides. Theme: business. Include a strong lead slide, one market slide, one traction slide, one roadmap slide, and a closing ask. Keep each slide presentation-friendly, not document-heavy.」

這種 prompt 夠具體，能讓 skill 的價值發揮出來，同時又不會把初稿限制得太死。

marp-slide skill 常見問題

marp-slide 比一般的投影片 prompt 更好嗎？

如果你需要的是 Marp 輸出，通常會更好。一般 prompt 也許能寫出還可以的投影片文字，但 marp-slide 還多了主題選擇、可重用模板、Marp 專用格式參考，以及更完整的預設工作流。

marp-slide 只適合開發者嗎？

不是。這個 repo 內含 business、academic 和 creative 等情境的主題。雖然底層技術性較高，因為 Marp 本身是 markdown-based，但實際適用範圍不只限於開發者分享。

新手也能用 marp-slide skill 嗎？

可以，尤其是照著模板走時最容易上手。最簡單的路徑是：先挑最接近的主題、提供受眾和目標，再讓代理先起一份短版 deck。你不需要很懂 Marp，也能從中得到實際價值。

什麼情況下 marp-slide 不適合？

以下情況就不建議用 marp-slide：

• 你需要的是 PowerPoint-native workflow，而且包含大量手動動畫
• 品牌規範要求客製企業模板，而這裡沒有對應
• 你的輸出其實是一篇長報告，不是投影片 deck
• 你根本不打算使用 Marp 或 markdown

marp-slide 能處理自訂樣式嗎？

部分可以。內建 CSS 主題已經能涵蓋不少需求，references/theme-css-guide.md 也能協助你做修改。但如果你要的是完整、全客製的設計系統，就要預期在 base skill 之外再做額外編修。

marp-slide 適合做圖片很多的 deck 嗎？

可以，但前提是你要把圖片需求講清楚。skill 內含 references/image-patterns.md，這點很重要，因為 Marp 的圖片版面對語法相當敏感。如果視覺是主角，請直接指定哪些頁要放圖，以及那些圖是拿來做什麼的。

如何把 marp-slide skill 用得更好

提供更好的來源素材

marp-slide 品質提升最大的一步，通常來自更好的輸入，而不是多加幾個形容詞。好的來源素材包括：

• 一份有優先順序的粗略大綱
• 依主題分組的原始筆記
• 一段需要濃縮的文件內容
• 希望的投影片數與時間配置
• 你想模仿的 deck 範例

如果只是把沒整理的內容整包丟進去，代理就得自己猜敘事線。

明確說出受眾與決策結果

一份好的 marp-slide brief，會清楚寫出受眾在看完 deck 後應該理解什麼、或做出什麼決定。例如：

• 核准遷移計畫
• 理解某項研究發現
• 在幾個選項之間做選擇
• 記住教學重點

這會幫助代理判斷哪些內容值得獨立成頁，哪些應該刪掉。

避免第一版就變成文字牆

一個常見失敗模式是投影片塞太滿。要改善 marp-slide 輸出，可以直接要求：

• 每頁更少 bullets
• 更短的標題
• 高密度主題拆成兩頁
• 一頁只講一個訊息
• 用更適合講述的表述，而不是文件式長文

如果你的來源素材本身是 memo 或逐字稿，這點尤其重要。

先用對模板，再考慮改 CSS

很多人太早跳進 theme CSS。更好的做法是：

1. 先選最接近的模板
2. 先確認結構和可讀性
3. 真的有需要，再微調顏色、留白或字體

如果 deck 本身結構就弱，改 CSS 也救不回來。

用精準的修訂要求迭代 marp-slide

第一版出來後，不要只回一句「幫我改好一點」。更好的修訂 prompt 例如：

• 「Reduce slide 4 to three bullets and add a clearer takeaway.」
• 「Convert slides 5 and 6 into a problem/solution pair.」
• 「Switch from default to business and tighten the tone for executives.」
• 「Add one image-friendly slide using Marp-compatible layout patterns.」

這種有明確方向的修訂，通常比籠統的風格要求更能得到好的第二版。

把 repository 參考文件當成品質檢查表

一個很實用的 marp-slide 提升方式，是把參考檔當成初稿完成後的檢查清單：

• 語法是否正確：references/marp-syntax.md
• 圖片使用是否正確：references/image-patterns.md
• 設計是否夠俐落：references/best-practices.md
• 是否需要更深的客製：references/advanced-features.md 和 references/theme-css-guide.md

這樣一來，skill 就不只是一次性的 prompt，而會變成可重複使用的簡報工作流程。

了解 marp-slide 的主要取捨

marp-slide 的強項，是快速產出可信、可用的 Marp deck。它的取捨在於：整體設計明顯偏向 Marp 結構與內建主題。如果你要的是像素級、完全客製的簡報設計，最適合的用法是先拿它做快速起稿和結構整理，再往下客製，而不是期待第一版就完全符合最終品牌標準。