feat(book): YouTube 임베드 추가 및 ipynb-youtube-embed 스킬 신설

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: Funbucket

.claude/skills/ipynb-youtube-embed/SKILL.md

@@ -0,0 +1,83 @@
+---
+name: ipynb-youtube-embed
+description: |
+  Jupyter 노트북에 YouTube 영상을 임베드하는 스킬.
+  Jupyter Book(GitHub Pages)에서 iframe이 올바르게 렌더링되도록
+  출력(outputs)까지 함께 저장한다.
+
+  트리거: "유튜브 임베드", "YouTube 임베드", "영상 노트북에 추가", "embed video"
+---
+
+# ipynb-youtube-embed
+
+Jupyter Book으로 배포되는 `.ipynb`에 YouTube iframe을 삽입하는 워크플로우.
+
+## 핵심 원칙
+
+Jupyter Book은 노트북을 **실행하지 않고** 저장된 `outputs`를 그대로 렌더링한다.
+따라서 코드 셀을 삽입할 때 `outputs`에 HTML 출력을 **미리 저장**해야 iframe이 표시된다.
+`outputs`가 비어 있으면 코드만 보이고 iframe은 렌더링되지 않는다.
+
+## 삽입 방법
+
+### 1. YouTube에서 iframe 코드 복사
+
+YouTube 영상 → 공유 → 퍼가기 → `<iframe ...>` 전체 복사
+
+### 2. 노트북 JSON에 코드 셀 + 출력 삽입
+
+```python
+import json
+
+NOTEBOOK = "book/{topic}/{notebook}.ipynb"
+IFRAME = '<iframe width="560" height="315" src="https://www.youtube.com/embed/{VIDEO_ID}" ...></iframe>'
+
+with open(NOTEBOOK) as f:
+    nb = json.load(f)
+
+cell = {
+    "cell_type": "code",
+    "execution_count": 1,
+    "metadata": {"tags": ["hide-input"]},
+    "source": [
+        "from IPython.display import HTML\n",
+        f"HTML('''{IFRAME}''')"
+    ],
+    "outputs": [
+        {
+            "data": {
+                "text/html": [IFRAME],
+                "text/plain": ["<IPython.core.display.HTML object>"]
+            },
+            "execution_count": 1,
+            "metadata": {},
+            "output_type": "execute_result"
+        }
+    ]
+}
+
+# 제목 셀(Cell 0) 바로 아래 삽입
+nb['cells'].insert(1, cell)
+
+with open(NOTEBOOK, 'w') as f:
+    json.dump(nb, f, ensure_ascii=False, indent=1)
+```
+
+## 태그 선택 기준
+
+| 태그 | 효과 | 사용 시점 |
+|------|------|-----------|
+| `hide-input` | 코드 접힘, 출력(iframe)만 표시 | 기본값 — 독자에게 Python 코드가 불필요할 때 |
+| `remove-input` | 코드 완전 제거, 출력만 표시 | 코드 존재 자체를 숨기고 싶을 때 |
+| (없음) | 코드 + 출력 모두 표시 | 코드 노출이 필요할 때 |
+
+## 삽입 위치 기준
+
+- **제목 바로 아래(Cell 1)**: 영상이 해당 노트북 전체를 커버하는 경우 (기본값)
+- **특정 섹션 아래**: 영상이 특정 개념만 다루는 경우
+
+## 주의사항
+
+- `outputs`를 빈 배열로 두면 Jupyter Book에서 iframe이 **절대 렌더링되지 않는다**.
+- `text/html` 값은 반드시 **리스트 형태** (`["<iframe ...>"]`)여야 한다.
+- 언어별 노트북이 분리된 경우(`_ko.ipynb`, `_en.ipynb`), 각각 따로 삽입한다.

README-ko_kr.md

@@ -42,6 +42,7 @@ causal_studio/
 | `book-serve` | Jupyter Book 로컬 서버 실행 |
 | `book-publish` | 노트북을 book TOC에 추가하고 빌드 검증 |
 | `ipynb-to-english` | 한국어 노트북을 영어 `_en.ipynb`로 번역 |
+| `ipynb-youtube-embed` | 노트북에 YouTube iframe 임베드 (Jupyter Book 렌더링을 위해 outputs까지 저장) |
 | `manim-video-pipeline` | scene 설계 / 스크립트 / 렌더 / 오디오 / mux / 합본 전 과정 |
 | `manim-thumbnail` | Manim으로 3b1b 스타일 YouTube 썸네일 PNG 생성 |
 | `git-commit` | 변경 분석 및 커밋 |

README.md

@@ -42,6 +42,7 @@ Install local video assets     → video-assets-setup skill
 | `book-serve` | Run Jupyter Book local server |
 | `book-publish` | Add notebook to book TOC and verify build |
 | `ipynb-to-english` | Translate Korean notebook to English `_en.ipynb` |
+| `ipynb-youtube-embed` | Embed a YouTube iframe into a notebook (with pre-stored output for Jupyter Book) |
 | `manim-video-pipeline` | Scene design / script / render / audio / mux / concat |
 | `manim-thumbnail` | Generate a 3b1b-style YouTube thumbnail PNG with Manim |
 | `git-commit` | Analyze changes and commit |

book/why_causal_inference/why_causal_inference_ko.ipynb

@@ -10,6 +10,35 @@
     "# 우리가 왜 인과추론에 관심을 가져야 할까요?\n"
    ]
   },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "01f15a40",
+   "metadata": {
+    "tags": [
+     "hide-input"
+    ]
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/html": [
+       "<iframe width=\"560\" height=\"315\" src=\"https://www.youtube.com/embed/IKurxtuTb3o?si=lz1U1Np592ci_u14\" title=\"YouTube video player\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen></iframe>"
+      ],
+      "text/plain": [
+       "<IPython.core.display.HTML object>"
+      ]
+     },
+     "execution_count": 1,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "from IPython.display import HTML\n",
+    "HTML('''<iframe width=\"560\" height=\"315\" src=\"https://www.youtube.com/embed/IKurxtuTb3o?si=lz1U1Np592ci_u14\" title=\"YouTube video player\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen></iframe>''')"
+   ]
+  },
   {
    "cell_type": "markdown",
    "id": "643181d0",