marp-slide

marp-slideスキルの概要

marp-slideでできること

marp-slide は、ざっくりしたプレゼン依頼を、完成度の高いMarpスライドデッキへ落とし込むためのスキルです。あらかじめ用意されたテーマ、スライド構成のガイド、Marp専用の構文リファレンスを使って、実用的なスライド用markdownを素早く作れます。単に「スライドを書いて」と頼んだときの汎用的な回答ではなく、すぐ使えるMarp前提の成果物がほしい人に向いています。

marp-slideを使うべき人

次のような場合は marp-slide が向いています。

• メモ、アウトライン、会議内容からスライドを作ることが多い
• PowerPoint専用の出力ではなく、Marp互換のmarkdownがほしい
• CSSを手でデザインしなくても、見た目の統一感を出したい
• エージェントに「いい感じに整えて」と頼むことが多く、その依頼を実際の作業フローに落とし込みたい

このスキルが最も活きる仕事

本質的な仕事は、単なる「箇条書き生成」ではありません。やるべきことは、内容に合うテーマを選び、伝わる構成でスライドを組み、レンダリング直前まで持っていけるMarp markdownを作ることです。Marpの構文、画像配置、テーマ設計を毎回調べずに、アイデアからデッキまで短時間で進めたいときに効きます。

marp-slideが他と違う点

通常のプロンプトと比べると、marp-slide には次の強みがあります。

• 7種類のビジュアル方向性を同梱: default, minimal, colorful, dark, gradient, tech, business
• assets/ にそのまま流用できるテンプレートファイルがある
• Marp構文、画像レイアウト、テーマ選定、高度な機能、CSSカスタマイズの参考資料がそろっている
• 「プロっぽくして」「かっこよくして」のような曖昧な依頼にも対応しやすい、実践寄りのワークフローがある

インストール前に気になるポイント

導入判断で気になる点は、だいたい次の4つです。

• ゼロからプロンプトを書くより時間短縮になるか？
  Marp出力が目的なら、たいていは短縮になります。
• 柔軟性はあるか？
  テーマ選択やデッキのたたき台作成には十分柔軟ですが、厳密なブランドシステムへの対応はやや弱めです。
• 初心者でも使いやすいか？
  おおむね使いやすいです。テンプレートとリファレンスがあるので、Marp特有の手探りを減らせます。
• どんなプレゼン形式にも向いているか？
  いいえ。最も力を発揮するのは、出力先がMarp markdownであるケースです。

marp-slideスキルの使い方

marp-slideのインストール前提

エージェント環境がSkillsのインストールに対応しているなら、よくあるツールキットのパターンは次のとおりです。

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

別のセットアップでこのインストーラーを使わない場合は、リポジトリ内の skills/marp-slide を直接開き、その中のファイルを作業用リファレンスとして使ってください。重要なのは、marp-slide は SKILL.md だけでなく、assets/ と references/ の補助ファイルまでエージェントが読める状態で最も力を発揮する、という点です。

最初に読むべきファイル

最短でキャッチアップしたいなら、読む順番は次がおすすめです。

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

この順番で読めば、リポジトリを深掘りしすぎずに、必要な情報を効率よく取れます。

marp-slideに渡すべき入力

marp-slide が最もうまく働くのは、次の情報がそろっているときです。

• 対象読者: 経営層、学生、エンジニア、顧客
• 目的: 説得する、説明する、教える、進捗報告する
• デッキの長さ: 目標スライド枚数、または持ち時間
• 元になる素材: メモ、箇条書き、文書の抜粋、会議要約
• トーン: フォーマル、技術寄り、ミニマル、勢い重視
• 見た目の希望: テーマ、light/dark、画像多めか文字少なめか
• 出力条件: 純粋なMarp markdownか、speaker notesあり/なし か

「スライドを作って」とだけ依頼しても下書きはできますが、テーマ選定や1枚あたりの情報量はどうしても推測頼みになります。

雑な依頼を、強いmarp-slideプロンプトに変える

弱いプロンプト:

• “Create slides about our API migration.”

より良いプロンプト:

• “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.”

このレベルまで文脈を渡せると、marp-slide は構成、情報密度、テーマをかなり適切に選びやすくなります。

出力に本当に効くテーマ選び

テーマの選択は、多くの人が思う以上に、読みやすさや場への適合性に影響します。

• tech: エンジニア向け、プロダクト構成、開発者向け発表
• business: 四半期レビュー、提案資料、対顧客・社内報告
• minimal: 学術発表、ワークショップ、ドキュメント寄りのデッキ
• colorful または gradient: イベント、クリエイティブ用途、販促、軽やかなトーン
• dark: 暗い会場での投影、またはコントラストを強めたいとき
• default: 要件が広い、あるいは曖昧なときの無難な選択

スタイルの言語化にこだわりがないなら、自分の好みよりも「誰に見せるか」で選ぶほうが失敗しにくいです。

白紙から始めず、テンプレートから入る

実務的な 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

エージェントにゼロから書式を考えさせるより、この方法のほうが安定します。これらのテンプレートには、すでにレイアウト、タイポグラフィ、余白の判断が織り込まれているからです。

実際のスライド作成で使いやすい流れ

安定して使える流れは次のとおりです。

1. テーマを選ぶ
2. 伝えるべきメッセージと対象読者を整理する
3. まずスライドアウトラインを作る
4. 各スライドをMarp markdownに展開する
5. 画像や図は、理解を助ける箇所にだけ入れる
6. レンダリングして、文字が多すぎるスライドを削る・絞る
7. CSSの調整は、デッキの構造が機能してから行う

この順番にしておくと、「構成が固まる前に見た目に時間を使いすぎる」というよくある失敗を避けられます。

デッキ品質を目に見えて上げるコツ

marp-slide の出力を良くしたいなら、次が効きます。

• 依頼内容が散らかっているなら、いきなり全文ではなく、先にスライドアウトラインを作らせる
• 発表向けにしたいなら「1枚あたり3〜5 bulletsまで」と明示する
• 文字中心ではなく、どのスライドをビジュアル寄りにするか指定する
• タイトルスライドとクロージングスライドが必要なら明記する
• 話す時間を伝える。枚数と情報密度に強く影響するためです

「プロっぽくして」のような抽象表現より、こうした具体入力のほうが初稿の質を大きく押し上げます。

Marpリファレンスを使うべき場面

これらのリファレンスは、単なる背景資料ではなく、詰まりやすいポイントを解決するためのものです。

• references/marp-syntax.md: 基本的な記法とdirective
• references/image-patterns.md: 画像配置と公式Marpitパターン
• references/best-practices.md: スライド密度と構成のベストプラクティス
• references/advanced-features.md: さらに表現力のあるレイアウトや効果
• references/theme-css-guide.md: CSSのカスタマイズ方法
• references/official-themes.md: Marpテーマ全体の整理と比較

単にmarkdownとして読みやすいだけでなく、きれいにレンダリングできる出力にしたいなら、必要な場面でこれらを参照する価値があります。

marp-slideの使用プロンプト例

たとえば、次のようなプロンプトで呼び出せます。

“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.”

このくらい具体的であれば、marp-slide の価値を引き出しつつ、下書きを縛りすぎることもありません。

marp-slideスキルFAQ

marp-slideは普通のスライド作成プロンプトより優れている？

Marp出力が必要なら、たいていはYesです。通常のプロンプトでもスライド文面自体はそこそこ作れますが、marp-slide にはテーマ選択、再利用できるテンプレート、Marp固有の書式リファレンス、そしてより実践的なデフォルトワークフローがあります。

marp-slideは開発者向けだけ？

いいえ。リポジトリには、ビジネス、アカデミック、クリエイティブ用途向けのテーマも含まれています。Marp自体がmarkdownベースなので土台は技術寄りですが、実際の利用シーンは開発者トークに限りません。

初心者でもmarp-slideを使える？

はい。特にテンプレートに沿って使うなら十分扱えます。いちばん簡単なのは、「近いテーマを選ぶ → 対象読者と目的を伝える → 短めのデッキを下書きさせる」という流れです。Marpを深く理解していなくても、十分価値を得られます。

marp-slideが向かないのはどんなとき？

次のような場合は marp-slide を無理に使わないほうがよいです。

• PowerPointネイティブで、細かな手動アニメーションを多用したい
• 厳格なブランド準拠のため、ここにない専用の企業テンプレートが必要
• 実際に作りたいものがスライドではなく、長文レポートである
• Marpやmarkdownをそもそも使う予定がない

marp-slideでカスタムスタイリングはできる？

ある程度までは可能です。同梱のCSSテーマでかなりカバーできますし、references/theme-css-guide.md も変更の助けになります。ただし、完全に独自のデザインシステムが必要な場合は、ベーススキルの範囲を超える追加編集を見込んだほうがよいです。

marp-slideは画像中心のデッキにも使える？

はい。ただし、画像の役割を明確に伝えた場合に限って効果的です。marp-slide には references/image-patterns.md があり、Marpでは画像レイアウトが構文に強く依存するため、ここが重要になります。ビジュアルが中心なら、どのスライドに画像を入れるか、その画像が何の役割を持つかまで指定してください。

marp-slideスキルを改善するには

元になる素材を良くする

marp-slide の品質を最も大きく左右するのは、形容詞を増やすことではなく、入力素材の質です。良い入力例としては次のようなものがあります。

• 優先順位つきのラフなアウトライン
• トピックごとに整理された生メモ
• 要約したい文書の一部分
• 希望するスライド枚数と持ち時間
• 近い仕上がりイメージの参考デッキ

整理されていない情報の投げ込みだけだと、エージェントは物語の流れを推測するしかなくなります。

対象読者と求める判断結果を明示する

強い marp-slide の依頼文では、デッキを見たあとに相手に何を理解してほしいのか、何を決めてほしいのかまで示します。たとえば次のようなものです。

• 移行計画を承認してもらう
• 調査結果を理解してもらう
• 複数案から選んでもらう
• 教えるポイントを記憶してもらう

ここが明確だと、どの話題を1枚使って見せるべきか、何を削るべきかをエージェントが判断しやすくなります。

文字だらけの初稿を防ぐ

よくある失敗は、1枚に情報を詰め込みすぎることです。marp-slide の出力を改善するには、次のように依頼すると効果的です。

• 1枚あたりの箇条書きを減らす
• 見出しを短くする
• 密度の高い話題は2枚に分ける
• 1スライド1メッセージにする
• 文書調の文章より、話しやすい表現を優先する

元資料がメモや議事録ではなく、長めの文書やトランスクリプトである場合は特に重要です。

CSS編集の前に適切なテンプレートを使う

テーマCSSに早く手を入れすぎるケースは少なくありません。より良い進め方は次の順です。

1. いちばん近いテンプレートを選ぶ
2. 構成と読みやすさを確認する
3. そのうえで必要なら色、余白、タイポグラフィを調整する

デッキの構造が弱いままだと、CSSをいじっても根本的な改善にはなりません。

修正依頼は、狙いを絞って出す

初稿のあとに「もっと良くして」だけで済ませるのはおすすめしません。次のような修正依頼のほうが効果的です。

• “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.”

大まかなスタイル指定より、こうしたピンポイントの修正依頼のほうが、2回目の出力品質は上がりやすいです。

リポジトリ内のリファレンスを品質チェックに使う

marp-slide の結果を改善する実践的な方法として、参考ファイルを「作成後のチェックリスト」として使うやり方があります。

• 構文の妥当性: references/marp-syntax.md
• 画像配置の正しさ: references/image-patterns.md
• デザイン面の仕上がり: references/best-practices.md
• より深いカスタマイズ: references/advanced-features.md と references/theme-css-guide.md

こうすると、このスキルは一発生成のプロンプトではなく、再現性のあるスライド作成フローとして使えるようになります。

marp-slideの主なトレードオフを理解する

marp-slide の強みは、説得力のあるMarpデッキを短時間で形にできることです。一方で、Marpの構造と同梱テーマを前提にした、ある程度「流儀のある」スキルでもあります。ピクセル単位で作り込む完全オーダーメイドのプレゼンデザインがほしいなら、まずは素早い下書きと構成設計に marp-slide を使い、その後に追加で調整する前提で考えるのが現実的です。初回からブランド完成形を期待しすぎないほうがうまくいきます。