docs

Original source / Raw SKILL.md

---
name: docs
description: "Generates documentation files including NotebookLM YAML and slide content. Use when user mentions ドキュメント, document, YAML, NotebookLM, スライド, slide, プレゼン. Do NOT load for: 実装作業, コード修正, レビュー, デプロイ."
allowed-tools: ["Read", "Write", "Edit"]
---

# Docs Skills

ドキュメント生成を担当するスキル群です。

## 機能詳細

| 機能 | 詳細 |
|------|------|
| **NotebookLM YAML** | See [references/notebooklm-yaml.md](references/notebooklm-yaml.md) |
| **スライド YAML** | See [references/notebooklm-slides.md](references/notebooklm-slides.md) |

## 実行手順

1. ユーザーのリクエストを分類
2. 上記の「機能詳細」から適切な参照ファイルを読む
3. その内容に従って生成


---

## Referenced Files

> The following files are referenced in this skill and included for context.

### references/notebooklm-yaml.md

```markdown
---
name: notebooklm-yaml
description: "NotebookLMの「スライド資料をカスタマイズ」で使うデザインYAMLを2案生成。プレゼン資料を作りたい場合に使用します。"
allowed-tools: ["Read", "Write"]
---

# NotebookLM YAML Skill

NotebookLM のスライド生成で、デザインの方向性をYAMLでコントロールするためのスキル。

---

## トリガーフレーズ

- 「NotebookLMのスライドをいい感じのデザインで作りたい」
- 「プレゼン用のYAMLを作って」
- 「スライドデザインを2案出して」

---

## ヒアリング項目

1. 目的（社内共有/営業/採用/投資家向け）
2. 想定読者（経営/開発/非エンジニア）
3. トーン（信頼感/革新/親しみ）
4. ブランド要素（ロゴ/ブランドカラー/フォント指定）
5. 写真/図表の比率（写真多め/データ多め）

---

## 出力

- **案A**: ミニマル/コーポレート（可読性・信頼感・データ重視）
- **案B**: エディトリアル/ストーリー（余白・写真・情緒重視）

```

### references/notebooklm-slides.md

```markdown
---
name: docs-notebooklm-slide-yaml
description: "NotebookLM の［スライド資料をカスタマイズ］で使えるデザイン指示YAMLを2案（別角度）生成して出力する。"
allowed-tools: ["Read", "Write"]
---

# NotebookLM Slide Design YAML (2 Variations)

## 目的

NotebookLM の「スライド資料」生成で、**デザインの方向性をYAMLで明示して品質と再現性を上げる**。

このスキルは、同じソースでも見た目を変えられるように、**意図の捉え方が異なる2案**のYAMLを出力します。

参考（使い方/作例）:
- `https://note.com/yoshifujidesign/n/nd9c8db0b55b8`
- `https://note.com/yoshifujidesign/n/n7412bccb5762`

---

## 使い方（NotebookLM 側）

NotebookLMで資料ソースを読み込んだ後、
［スライド資料］→［スライド資料をカスタマイズ］→［作成するスライドについて説明してください］
に **このスキルが出力するYAML全文を貼り付けて**［生成］します。

---

## 入力（ユーザーに確認すること）

可能なら最初に以下を最大5問で確認し、回答がなければ括弧のデフォルトで進めます。

1. 目的（例: 社内共有/営業/採用/投資家向け） (社内共有)
2. 想定読者（例: 経営/開発/非エンジニア） (非エンジニア混在)
3. トーン（例: 信頼感/革新/親しみ） (信頼感)
4. ブランド要素（ロゴ/ブランドカラー/フォント指定） (指定なし)
5. 写真/図表の比率（写真多め/データ多め） (データ多め)

---

## 出力（必須フォーマット）

以下の **2案**を必ず出力すること。

- 案A: **可読性・信頼感・データ伝達を最優先**（ミニマル/コーポレート）
- 案B: **情緒・ストーリー・余白の美学を重視**（エディトリアル/ライフスタイル）

どちらも **日本語YAML**で、NotebookLMにそのまま貼れる形にする。

出力形式:

- `### 案A` の直下に YAML を1つ（コードブロック）
- `### 案B` の直下に YAML を1つ（コードブロック）

---

## 生成ルール

- 具体的な色は **HEX** を含める（例: `#FFFFFF`）
- 「やってはいけない」も少し書く（例: 枠線多用禁止、過剰な影禁止、色数制限）
- 章立て/ナビゲーション/余白/グリッドなど、**再現性に効く制約を明文化**
- 内容（ソース）が不明でも成立するよう、**構造テンプレ**として書く

---

## 出力テンプレ（生成例の骨格）

### 案A（ミニマル/コーポレート）

（必要に応じて、目的/読者/ブランド色に合わせて微調整する）

```yaml
# presentation_design_spec_minimal_corporate_jp.yaml
# スタイル: モダン・ミニマル / コーポレート
# 目的: 可読性とデータ伝達を最優先（信頼感）

全体デザイン設定:
  トーン: "信頼感、プロフェッショナル、クリーン、論理的"
  配色パレット:
    ベース: "#FFFFFF (白) または #F5F5F7 (非常に薄いグレー)"
    文字色: "#111111 (ほぼ黒) または #333333 (チャコール)"
    アクセント: "ブランドカラーがあればそれを使用。なければ #0052CC (ブルー) を採用"
    強調: "#FFB020 (アンバー) - 重要な数値や注意に限定"
    色数制限: "最大3色 + グレー階調"
  タイポグラフィ:
    見出し: "太めのゴシック体（サンセリフ）。短く強い言葉。"
    本文: "可読性の高いゴシック体。行間を広めに。"
    数字: "サンセリフ太字で大きく。単位（%など）は小さめ。"
  共通レイアウト・ルール:
    グリッド: "12カラム相当で整列。左右余白を広く。"
    ナビゲーション: "左上に '01. SECTION' のような番号＋章題を小さく表示。"
    余白: "詰め込み禁止。1スライド1メッセージ。"
    図表: "罫線/グリッド線は最小。強調点のみアクセント色。"
  NG事項:
    - "過剰なドロップシャドウ禁止"
    - "装飾枠の多用禁止"
    - "グラデーション多用禁止"

レイアウト・バリエーション（カタログ）:
  - タイプ: "表紙"
    デザイン: "余白大。タイトルは左寄せで大きく、サブタイトルは小さく。薄い横罫線を1本。"
  - タイプ: "章扉"
    デザイン: "章タイトルを大きく。背景は単色でミニマル。"
  - タイプ: "結論（TL;DR）"
    デザイン: "結論3点 + 大きな数字/指標を1つ。"
  - タイプ: "2カラム（課題 vs 解決）"
    デザイン: "縦線で2分割。左:課題、右:解決。見出し太字、本文細字。"
  - タイプ: "データ/チャート"
    デザイン: "棒/折れ線のシンプル表現。注釈は短く。"
  - タイプ: "プロセス"
    デザイン: "水平ステップ（01-05）。丸アイコンは最小。"
  - タイプ: "タイムライン"
    デザイン: "縦線 + 年号大 + 説明小。"
  - タイプ: "まとめ"
    デザイン: "次アクションを3点。チェックリスト風に簡潔に。"
```

### 案B（エディトリアル/ストーリー）

（必要に応じて、目的/読者/写真比率に合わせて微調整する）

```yaml
# presentation_design_spec_editorial_story_jp.yaml
# スタイル: モダン・エディトリアル / ライフスタイル雑誌風
# 目的: 余白と写真でストーリーを語る（情緒/説得）

全体デザイン設定:
  トーン: "穏やか、知的、情緒的、オーガニック、洗練"
  ビジュアル・アイデンティティ:
    背景色: "#F3F0EB (サンドベージュ) または #EBEBEB (ウォームグレー)"
    文字色: "#333333 (チャコール) - 真っ黒は避ける"
    アクセントカラー: "#E07A5F (テラコッタ) または #708D81 (オリーブ)"
    画像スタイル:
      特徴: "自然光、フィルム粒子、彩度低め"
      形状: "角丸長方形 または アーチ型"
  タイポグラフィ:
    見出し: "上品な明朝/セリフ体。重要語は控えめに強調。"
    本文: "読みやすいゴシック/サンセリフで小さめ。"
    数字: "セリフ数字で落ち着きを出す。"
  共通レイアウト・ルール:
    余白: "余白を最優先。文字密度を下げる。"
    写真: "1スライド1枚の大きい写真を基本。"
    罫線: "枠線は禁止。区切りは余白か極細線のみ。"
  デザインルール:
    - "寒色・ネオンは禁止（温かいトーンで統一）"
    - "過剰なアイコンは禁止（写真とタイポで語る）"

レイアウト・バリエーション（カタログ）:
  - タイプ: "表紙（雑誌カバー）"
    デザイン: "右に写真フルブリード、左にタイトル。細い横罫線で区切る。"
  - タイプ: "引用（Quote）"
    デザイン: "短いメッセージを中央。背景に大きな引用符を薄く。"
  - タイプ: "ストーリー（1→2→3）"
    デザイン: "縦ステップ。点線で接続。各ステップ横に小さな丸写真。"
  - タイプ: "比較"
    デザイン: "左右2枚写真 + 各キャプション。色は抑えめ。"
  - タイプ: "データ"
    デザイン: "極細折れ線 + 説明文段落で補足（物語を添える）。"
  - タイプ: "まとめ"
    デザイン: "次アクションを3点。余白を残して締める。"
```



```