AgentSkillsCN

marp-slides

创建 Marp 格式的 Markdown 幻灯片,可用于面向工程师的技术分享、学习交流会,以及公司内部的知识共享。 触发条件:(1) 幻灯片制作需求;(2) 演讲材料准备;(3) 发表会演示文稿制作;(4) Marp 幻灯片生成。 文件格式:.md(Marp 格式)

SKILL.md
--- frontmatter
name: marp-slides
description: |
  Marp形式のMarkdownスライドを作成する。エンジニア向けの技術発表、勉強会、社内共有用スライドに使用。
  トリガー条件: (1) スライド作成依頼 (2) プレゼン資料作成 (3) 発表資料作成 (4) Marpスライド作成
  ファイル形式: .md (Marp形式)

Marp スライド作成スキル

基本方針

言葉遣いの原則

禁止事項:

  • 「アジェンダ」→「本日の内容」「目次」
  • 「AI」→「人工知能」(文脈で必要な場合のみ略称可)
  • 「フィジカル」→「物理的」「身体的」
  • 「ソリューション」→「解決策」「方法」
  • 「イシュー」→「課題」「問題」
  • 「コミット」(ビジネス文脈)→「取り組む」「責任を持つ」
  • 「シナジー」→「相乗効果」
  • 「スキーム」→「仕組み」「枠組み」
  • 「リソース」→「資源」「人員」「時間」
  • 「イノベーション」→「技術革新」「新しい取り組み」
  • 「トランスフォーメーション」→「変革」「転換」
  • 「ローンチ」→「公開」「開始」
  • 「バリュー」→「価値」
  • 過度な強調(「超」「めちゃくちゃ」「爆速」)

技術用語は原語のまま使用可: API, HTTP, JSON, Docker, Kubernetes, Git, CI/CD, REST, GraphQL など

口調

  • 「です・ます」調を基本とする
  • 箇条書きは体言止めも可
  • 「〜である」「〜だ」は強調したい場面のみ
  • 聴衆への呼びかけは控えめに(「皆さん」の多用を避ける)

工学的正確性

  1. 定義を先に示す: 専門用語を使う前に定義する
  2. 数値には根拠を示す: 出典・条件を明記
  3. 因果関係を明確に: 「なぜならば」「したがって」で論理をつなぐ
  4. 仮定と事実を区別: 「〜と考えられる」「〜である」を使い分ける

引用ルール

markdown
<!-- 画像の引用 -->

![説明](URL)
_出典: 著者名 (年). 論文/書籍タイトル_

<!-- 文章の引用 -->

> 引用文
> — 著者名『書籍名』(年)

<!-- 参考文献セクション -->

## 参考文献

1. 著者 (年). **タイトル** - [リンクテキスト](URL)

Marp フロントマター

yaml
---
marp: true
theme: default
paginate: true
header: 'タイトル'
footer: '年'
math: mathjax
html: true
style: |
  section {
    font-size: 28px;
  }
  .columns {
    display: flex;
    gap: 20px;
  }
  .col {
    flex: 1;
  }
  img[alt~="center"] {
    display: block;
    margin: 0 auto;
  }
---

スライド構成パターン

タイトルスライド

markdown
<!-- _class: lead -->
<!-- _paginate: false -->
<!-- _header: '' -->
<!-- _footer: '' -->

# タイトル

## サブタイトル

![bg right:40% 80%](画像URL)

目次スライド

markdown
## 本日の内容

1. **第1章タイトル**
2. **第2章タイトル**
3. **第3章タイトル**
4. **まとめ**

2カラムレイアウト

markdown
<div class="columns">
<div class="col">

### 左側の内容

- 項目1
- 項目2

</div>
<div class="col">

### 右側の内容

![center width:300px](画像URL)

</div>
</div>

章区切り

markdown
---
<!-- _class: lead -->

# 章タイトル

### 補足説明(任意)
---

視覚要素

Mermaid図

markdown
```mermaid
graph LR
    A[入力] --> B[処理]
    B --> C[出力]
```

```mermaid
sequenceDiagram
    participant C as クライアント
    participant S as サーバー
    C->>S: リクエスト
    S-->>C: レスポンス
```

```mermaid
flowchart TD
    A[開始] --> B{条件}
    B -->|はい| C[処理A]
    B -->|いいえ| D[処理B]
    C --> E[終了]
    D --> E
```

markdown
| 項目 | 説明 | 備考 |
| ---- | ---- | ---- |
| A    | ...  | ...  |
| B    | ...  | ...  |

数式

markdown
<!-- インライン -->

$E = mc^2$

<!-- ブロック -->

$$
\frac{\partial f}{\partial x} = \lim_{h \to 0} \frac{f(x+h) - f(x)}{h}
$$

YouTube埋め込み

markdown
<iframe width="720" height="405" src="https://www.youtube.com/embed/VIDEO_ID" frameborder="0" allowfullscreen></iframe>

背景画像

markdown
<!-- 右側に配置 -->

![bg right:45% 90%](画像URL)

<!-- 全体背景 -->

![bg](画像URL)

<!-- 複数画像 -->

![bg left:33%](画像1)
![bg](画像2)
![bg](画像3)

終了スライド

markdown
---

<!-- _class: lead -->
<!-- _paginate: false -->
<!-- _header: '' -->
<!-- _footer: '' -->

# ご清聴ありがとうございました

### 質問はありますか?

---

参考文献セクション

markdown
## 参考文献

### 論文・書籍

1. 著者 (年). **タイトル** - [リンク](URL)
2. 著者 (年). **タイトル** - 出版社

### 動画・その他

- タイトル: [youtube.com/watch?v=...](URL)

チェックリスト

作成後に確認:

  • カタカナビジネス用語を使っていないか
  • 専門用語は定義してから使っているか
  • 数値の出典・条件は明記されているか
  • 引用元は正しく記載されているか
  • Mermaid図や表を活用しているか
  • 各スライドの情報量は適切か(詰め込みすぎていないか)