[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M73DXT57Z6DF4G30K6R3DN61":3,"skill-same:01M73DXT57Z6DF4G30K6R3DN61":68},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":46,"commitSha":47,"skillDirectory":48,"forksCount":49,"repositoryHtmlUrl":50,"repositoryHomepageUrl":6,"ownerHtmlUrl":51,"ownerBlogUrl":6,"ownerDescription":52,"updatedAt":53,"install":54,"resources":67},"01M73DXT57Z6DF4G30K6R3DN61","html-build",null,"Generates HTML slides from slide_deck.md and design_spec.md. Applies theme (data-theme attribute), binds images from image-manifest.json, inserts speaker intro and contact slides, checks balance. Responds to \"make HTML\", \"generate slides\", \"add images\", \"add speaker intro\" (Korean: \"HTML 만들어줘\", \"슬라이드 생성해줘\", \"이미지 넣어줘\", \"강연자 소개 추가해줘\"). Stages 5-8 of the lecture workflow.","5throck\u002Fai-workspace-standards","5throck","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F10958964?v=4","01M73BFEH0V0VS483TW4JD49JW","01M73BFEJ5VQZJHJSFTVPAZGDM",25,"AGPL-3.0","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-deck\u002F.gemini\u002Fskills\u002Fhtml-build\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: html-build\nscope: co-deck\nversion: 1.7.0\ndescription: >\n  Generates HTML slides from slide_deck.md and design_spec.md. Applies theme\n  (data-theme attribute), binds images from image-manifest.json, inserts speaker\n  intro and contact slides, checks balance. Responds to \"make HTML\", \"generate\n  slides\", \"add images\", \"add speaker intro\" (Korean: \"HTML 만들어줘\", \"슬라이드\n  생성해줘\", \"이미지 넣어줘\", \"강연자 소개 추가해줘\"). Stages 5-8 of the lecture\n  workflow.\nstatus: active\nowner: html-build\nlast_reviewed: 2026-11-10\nprerequisites: design\nrelates_to:\n  - skill: pdf-export\n    type: follows\n  - skill: slide-layout-gate\n    type: follows\n  - skill: pdf-export\n    type: composes_with\n  - skill: research\n    type: composes_with\n  - skill: storyline\n    type: composes_with\ninputs: [slide-deck-draft, design-spec]\noutputs: [slide-html]\n---\n\n## Context\n\nGenerates a single HTML file from `slide_deck.md` + `design_spec.md`, applies theme from `lecture-profile.md`, binds images from `image-manifest.json`, inserts special pages (speaker intro, contact), and checks balance. Slide data is embedded as a **strict-JSON** array (`const slideData = [...]`) inside the HTML. Strict-JSON means: all keys double-quoted, all string values double-quoted, no trailing commas, no JavaScript comments, no single-quoted strings, no template literals. Invoked at Stages 5-8, after Gate 3 (design approval).\n\n## When to Use\n\n- PM Agent dispatches after Gate 3 (design approval)\n- User says \"make HTML\" \u002F \"HTML 만들어줘\" \u002F \"슬라이드 생성해줘\"\n- User says \"add images\" \u002F \"이미지 넣어줘\"\n- User wants to edit specific slides\n\n---\n\n## Execution Steps\n\n### Stage 5: HTML Slide Generation\n\n**File Structure:** Single HTML file (`lecture_[topic]_v1.html`) + `assets\u002Fimages\u002F` folder (photos) + `assets\u002Fdiagrams\u002F` folder (SVG\u002FPNG diagrams).\n\n**slideData Structure:** Slide data lives as a **strict-JSON** array embedded as `const slideData = [...]` inside the HTML file. All keys and string values must use double-quotes; no trailing commas, no JS comments. This enables `extract_slidedata.mjs` to parse via `JSON.parse` directly without a transform step.\n\n> Korean example — field keys stay in English; only the content values are Korean.\n\n```javascript\n\u002F\u002F Cover\n{ isTitleSlide: true, section: \"\", title: \"강연 제목\", subtitle: \"부제목\",\n  meta: \"날짜 | 주최\", visualImage: \"..\u002Fassets\u002Fimages\u002Flecture-hall-professional.jpg\",\n  backgroundImage: \"..\u002Fassets\u002Fimages\u002Fbg-deck.jpg\" }\n\n\u002F\u002F Speaker intro (visualImage → portrait avatar on profile slides)\n{ isProfileSlide: true, section: \"INTRODUCTION\", title: \"강연자 소개\",\n  speakerName: \"이름\", speakerTitle: \"직책 \u002F 소속\", speakerBio: \"약력 (2-3줄)\",\n  visualImage: \"..\u002Fassets\u002Fimages\u002Fspeaker-portrait.jpg\" }\n\n\u002F\u002F Divider (part break)\n{ isDividerSlide: true, section: \"섹션명\", partNum: \"PART 01\",\n  title: \"파트 제목\", desc: \"이 파트에서 다룰 내용 한 줄 요약\",\n  visualImage: \"..\u002Fassets\u002Fimages\u002Fai-transformation-abstract.jpg\",\n  backgroundImage: \"..\u002Fassets\u002Fimages\u002Fbg-deck.jpg\" }\n\n\u002F\u002F Standard slide (image)\n{ section: \"섹션명\", title: \"슬라이드 제목\",\n  bullets: [\"불릿 1\", \"불릿 2\", \"불릿 3\"],\n  visualImage: \"..\u002Fassets\u002Fimages\u002Fdata-analysis-dashboard.jpg\" }\n\n\u002F\u002F Standard slide (text panel — structured visualDisplay)\n\u002F\u002F visualDisplay supports structured rendering via renderVisualDisplay():\n\u002F\u002F   [Box Title]  → .visual-heading (bold, accented)\n\u002F\u002F   ✓ \u002F → \u002F •    → .visual-item .visual-item-check (list marker)\n\u002F\u002F   (default)    → .visual-paragraph (normal text)\n{ section: \"섹션명\", title: \"슬라이드 제목\",\n  bullets: [\"불릿 1\", \"불릿 2\"],\n  visualTitle: \"핵심 포인트\", visualDisplay: \"[현재 상황]\\n✓ 항목 1\\n✓ 항목 2\\n\\n[개선 방향]\\n→ 방향 1\\n→ 방향 2\" }\n\n\u002F\u002F Contact (last slide)\n{ isContactSlide: true, section: \"CLOSING\", title: \"감사합니다\",\n  contactEmail: \"email@example.com\", contactLinkedIn: \"linkedin.com\u002Fin\u002F...\",\n  contactPhone: \"010-XXXX-XXXX\" }\n\n\u002F\u002F Punchline (impactful closing)\n{ isPunchlineSlide: true, section: \"\", title: \"핵심 메시지\" }\n\n\u002F\u002F Abbreviation footnotes (optional, any slide type)\n\u002F\u002F Renders as a small wrap-enabled line at the bottom-left of the slide\n\u002F\u002F (shared FootnoteBuilder — runs from initPPT, no per-theme work needed).\n\u002F\u002F Rule: define each abbreviation at its FIRST appearance per PART;\n\u002F\u002F skip divider\u002Fvideo slides and widely known terms (AI, company\u002Fmodel names).\n{ section: \"섹션명\", title: \"슬라이드 제목\", bullets: [\"불릿 1\"],\n  footnotes: [\"SMR: 소형모듈원전(Small Modular Reactor)\", \"EREV: 주행거리 연장형 전동화(Extended-Range Electric Vehicle)\"] }\n```\n\nUse `design_spec.md`'s CSS variables directly. Unify slide rendering through a single `renderSlide(data)` function. Do not hardcode color or font values.\n\n**Theme + Style injection** (from `lecture-profile.md` → `presentation.theme` + `presentation.style`):\n```html\n\u003Chtml lang=\"ko\" data-theme=\"pitch-enhanced\" data-style=\"premium-dark\">\n\u003Clink rel=\"stylesheet\" href=\"..\u002F..\u002Fdocs\u002Fhtml-themes\u002Fstyles\u002Fbase.css\">\n\u003Clink rel=\"stylesheet\" href=\"..\u002F..\u002Fdocs\u002Fhtml-themes\u002Fstyles\u002Fpremium-dark\u002Fstyle.css\">\n```\nAvailable themes: `outline | pitch | pitch-enhanced | vertical | zen`. Available styles: `classic | minimal | visual-heavy | academic | premium-dark`. Defaults: `pitch-enhanced` + `premium-dark`.\n\n> **Deterministic Builder (Task 4 — pending implementation):** A CLI `build-theme-deck.ts` will automate CSS injection, marker replacement, and ppt-engine.js inlining. Once available, html-build will invoke the builder instead of performing these steps manually. The builder handles: theme\u002Fstyle resolution, package validation, INJECT marker replacement, CSS link generation, ppt-engine.js inlining, strict-JSON slideData injection. html-build remains responsible for: slide content generation, image path binding, narration\u002Fauto-advance config assembly, and renderSlide() (template-provided).\n\n**Theme capabilities:**\n- All 5 themes support `visualImage`, `visualTitle`\u002F`visualDisplay` text panels, profile avatars, `contactPhone`, `isPunchlineSlide`, and `footnotes` (abbreviation footnotes via the shared FootnoteBuilder).\n- `pitch` and `pitch-enhanced` use `slide-content` grid (left text + right visual panel) for standard slides.\n- `outline`, `pitch-enhanced`, `zen`, `vertical` use `slide-card` (content + right-panel) for standard slides.\n- `outline`, `pitch-enhanced`, `zen`, `vertical` support PPT features (TOC drawer, transitions, timer, speaker notes, TTS).\n- `pitch` uses its own layout (TOC drawer, no transitions).\n- `visual-heavy` style uses `--slide-bg-image` CSS variable for full-bleed background images.\n\n**Narration and auto-advance config injection** (from `lecture-profile.md` → `narration` + `auto_advance` sections):\nRead the `narration` and `auto_advance` blocks from `lecture-profile.md` and inject two independent config objects into the `initPPT()` call. This bridges lecture profile settings to the runtime NarrationEngine v2.3:\n```javascript\n\u002F\u002F Inject before the DOMContentLoaded listener or alongside initPPT call\nvar narrationConfig = {\n  enabled: true,\n  autoPlay: false,\n  defaultLanguage: 'ko',\n  scriptLanguage: 'ko',\n  languages: ['ko']\n};\nvar autoAdvanceConfig = {\n  enabled: true,\n  startAsAuto: false,\n  interval: 8\n};\ninitPPT({ transition: 'fade', showTimer: true, showThumbnails: false,\n          narration: narrationConfig, autoAdvance: autoAdvanceConfig });\n```\n- `narration.enabled: false` → hides TTS play button, language dropdown, voice selector; disables 'P' keyboard shortcut\n- `narration.autoPlay: true` → auto-starts TTS narration on page load\n- `narration.scriptLanguage` → declares what language the primary `script` field is written in (defaults to `'ko'`); read from `script_language` in lecture-profile.md, falls back to `language` field\n- `auto_advance.enabled: false` → hides auto-advance toggle button; disables 'A' keyboard shortcut\n- `auto_advance.startAsAuto: true` → starts auto-advance timer immediately on page load\n- `auto_advance.interval` → configures the timer interval (seconds) for auto-advance slides\n- `narration.languages` → populates the language dropdown (only languages with scripts in slideData are clickable)\n- If `narration` section is absent, set `narration.enabled: false`. If `auto_advance` section is absent, use defaults (`enabled: true`, `startAsAuto: false`, `interval: 8`)\n- **Backward compatibility**: if the old single `narration.autoAdvance` or `narration.autoAdvanceInterval` fields are present, silently ignore them\n\n**Image paths:** Photos live in the shared pool at `presentations\u002Fassets\u002Fimages\u002F`. Use `..\u002Fassets\u002Fimages\u002F\u003Cslug>.\u003Cext>` (relative from `presentations\u002F\u003Cproject>\u002F`). Slug is the `path` field basename from `image-manifest.json`. No slide-number prefix. Diagrams (SVG\u002FPNG) live in the shared pool at `presentations\u002Fassets\u002Fdiagrams\u002F`. Use `..\u002Fassets\u002Fdiagrams\u002F\u003Cstem>.png` for diagram slides. Paths are auto-rewritten by `gen-visual-images.ts` when run.\n\n**Canonical rebuild order (U-20261105-007):** every rebuild follows build → style patch → video inject — a rebuild silently drops video players and style patches otherwise. `build-theme-deck.ts` runs the video injection itself after a successful build (idempotent, video-less decks untouched); pass `--download-videos` to pre-fetch the deck's YouTube videos into `presentations\u002Fassets\u002Fvideos\u002Fyt-\u003Cid>.mp4` before injection so offline playback binds local files. Re-apply the style patch after every rebuild.\n\n#### Font Parity (PDF ↔ HTML) — mandatory\n\nA deck's typography has ONE source of truth: the font family the PDF engine\nloads from `presentations\u002Fassets\u002Ffonts\u002F` (currently `Pretendard-Regular\u002FBold.ttf`,\nper `gen-slides-pdf.ts` `--font-dir` default). Every HTML build MUST:\n\n1. Embed that same family via `@font-face` from those same TTF files (CSS url\n   relative to the stylesheet's own location) and set it FIRST in `--font-family`.\n2. Keep system-font fallbacks (Noto Sans KR, Apple SD Gothic Neo) as resilience\n   only — they are never the delivered look.\n3. Verify before hand-off: Playwright `document.fonts.check('400 16px \u003CFamily>')`\n   and `document.fonts.check('700 24px \u003CFamily>')` must both be true.\n\nAny typography change (family, weights, font files) updates the PDF engine and\nthe HTML theme\u002Fpatch in the SAME change (spec activity per ADR-0074).\nDesign: `docs\u002Fdesigns\u002F2026-11-10-font-parity-ssot-principle-design.md`; gate\nrecord: `decisions\u002Fgates.yaml` DG-DECK-06 (S10 sample review).\n\n---\n\n### Stage 6: Image Binding\n\nRead `image-manifest.json` and bind downloaded images to matching slideData entries by slide index. For slides where no image was found by the Image Curator:\n- If slide has `image_role: background` → switch to `visualTitle` \u002F `visualDisplay` text panel fallback\n- If slide has `image_role: illustrative` → omit the right panel; switch to full-text layout\n- Never use placeholder or generic images — always use manifest paths or text fallback\n\n**Background image binding** (when `lecture-profile.md` → `background_image.enabled` is true):\n\n1. Read `background_image` config from `lecture-profile.md`\n2. Read the global background image path from `image-manifest.json` → `background_image.path`\n3. Convert to relative path: `..\u002Fassets\u002Fimages\u002F\u003Cslug>.\u003Cext>`\n4. Inject `backgroundImage` field into `slideData` entries based on scope:\n   - `all` → every slide gets `\"backgroundImage\": \"..\u002Fassets\u002Fimages\u002Fbg-deck.jpg\"`\n   - `divider-cover` → only slides where `isTitleSlide`, `isDividerSlide`, or `isPunchline` is true\n   - `individual` → only slides with `image_role: \"background\"` in the manifest\n5. The template's `renderSlide()` reads `data.backgroundImage` and sets `--slide-bg-image` CSS variable (consumed by `visual-heavy\u002Fstyle.css` for full-bleed backgrounds)\n\n---\n\n### Stage 7: Balance Check\n\nSelf-check after generating the HTML:\n\n- [ ] Total slide count matches the plan\n- [ ] Slide counts per chapter are balanced (within ±20%)\n- [ ] No slides with more than 5 bullets\n- [ ] No more than 3 consecutive slides without visuals\n- [ ] No overly long bullets (recommend under 40 chars\u002Fline)\n\nIf any issue, split or merge slides.\n\n---\n\n### Stage 8: Special Pages\n\n- **Speaker intro**: right after the cover (slide 2)\n- **Contact**: last slide\n\nInsert if either is missing. Populate with `instructor` fields from `lecture-profile.md`.\n\n> To open HTML locally: `bunx serve .` → `http:\u002F\u002Flocalhost:3000`\n\n---\n\n## Output Format\n\n`lecture_[topic]_v1.html` — single self-contained HTML file with embedded `const slideData` (strict JSON), theme `data-theme` attribute, base + override CSS links, and `assets\u002Fimages\u002F` (photos) + `assets\u002Fdiagrams\u002F` (SVG\u002FPNG) alongside.\n\n> PDF pipeline note: `scripts\u002Fco-deck\u002Fextract_slidedata.mjs` parses the inline `const slideData = [...]` array via a bracket-depth state machine (not regex, not DOM). The slideData array **MUST be strict JSON** — all keys double-quoted, string values double-quoted, no trailing commas, no JS comments, no single quotes. Non-JSON syntax will break the PDF pipeline.\n>\n> **Encoding**: All output HTML files MUST be UTF-8 without BOM. Verify `\u003Cmeta charset=\"UTF-8\">` is present in `\u003Chead>`. On Korean Windows systems, ensure `chcp 65001` is active before writing files to prevent CP949 corruption of Korean text content.\n\n> **Builder Boundary:** See `agents\u002Fhtml-build.md` \"Builder Boundary\" section for the complete responsibility split between the builder and the html-build agent.\n\n## Related Skills\n\n- `design` — provides `design_spec.md` CSS variables consumed by this skill\n- `image-curator` — produces `image-manifest.json` that maps slide indices to image paths\n- `measure` — next step; consumes the HTML output to extract pixel coordinates\n- `version` — must be called before any HTML file edit\n","## Context\n\nGenerates a single HTML file from `slide_deck.md` + `design_spec.md`, applies theme from `lecture-profile.md`, binds images from `image-manifest.json`, inserts special pages (speaker intro, contact), and checks balance. Slide data is embedded as a **strict-JSON** array (`const slideData = [...]`) inside the HTML. Strict-JSON means: all keys double-quoted, all string values double-quoted, no trailing commas, no JavaScript comments, no single-quoted strings, no template literals. Invoked at Stages 5-8, after Gate 3 (design approval).\n\n## When to Use\n\n- PM Agent dispatches after Gate 3 (design approval)\n- User says \"make HTML\" \u002F \"HTML 만들어줘\" \u002F \"슬라이드 생성해줘\"\n- User says \"add images\" \u002F \"이미지 넣어줘\"\n- User wants to edit specific slides\n\n---\n\n## Execution Steps\n\n### Stage 5: HTML Slide Generation\n\n**File Structure:** Single HTML file (`lecture_[topic]_v1.html`) + `assets\u002Fimages\u002F` folder (photos) + `assets\u002Fdiagrams\u002F` folder (SVG\u002FPNG diagrams).\n\n**slideData Structure:** Slide data lives as a **strict-JSON** array embedded as `const slideData = [...]` inside the HTML file. All keys and string values must use double-quotes; no trailing commas, no JS comments. This enables `extract_slidedata.mjs` to parse via `JSON.parse` directly without a transform step.\n\n> Korean example — field keys stay in English; only the content values are Korean.\n\n```javascript\n\u002F\u002F Cover\n{ isTitleSlide: true, section: \"\", title: \"강연 제목\", subtitle: \"부제목\",\n  meta: \"날짜 | 주최\", visualImage: \"..\u002Fassets\u002Fimages\u002Flecture-hall-professional.jpg\",\n  backgroundImage: \"..\u002Fassets\u002Fimages\u002Fbg-deck.jpg\" }\n\n\u002F\u002F Speaker intro (visualImage → portrait avatar on profile slides)\n{ isProfileSlide: true, section: \"INTRODUCTION\", title: \"강연자 소개\",\n  speakerName: \"이름\", speakerTitle: \"직책 \u002F 소속\", speakerBio: \"약력 (2-3줄)\",\n  visualImage: \"..\u002Fassets\u002Fimages\u002Fspeaker-portrait.jpg\" }\n\n\u002F\u002F Divider (part break)\n{ isDividerSlide: true, section: \"섹션명\", partNum: \"PART 01\",\n  title: \"파트 제목\", desc: \"이 파트에서 다룰 내용 한 줄 요약\",\n  visualImage: \"..\u002Fassets\u002Fimages\u002Fai-transformation-abstract.jpg\",\n  backgroundImage: \"..\u002Fassets\u002Fimages\u002Fbg-deck.jpg\" }\n\n\u002F\u002F Standard slide (image)\n{ section: \"섹션명\", title: \"슬라이드 제목\",\n  bullets: [\"불릿 1\", \"불릿 2\", \"불릿 3\"],\n  visualImage: \"..\u002Fassets\u002Fimages\u002Fdata-analysis-dashboard.jpg\" }\n\n\u002F\u002F Standard slide (text panel — structured visualDisplay)\n\u002F\u002F visualDisplay supports structured rendering via renderVisualDisplay():\n\u002F\u002F   [Box Title]  → .visual-heading (bold, accented)\n\u002F\u002F   ✓ \u002F → \u002F •    → .visual-item .visual-item-check (list marker)\n\u002F\u002F   (default)    → .visual-paragraph (normal text)\n{ section: \"섹션명\", title: \"슬라이드 제목\",\n  bullets: [\"불릿 1\", \"불릿 2\"],\n  visualTitle: \"핵심 포인트\", visualDisplay: \"[현재 상황]\\n✓ 항목 1\\n✓ 항목 2\\n\\n[개선 방향]\\n→ 방향 1\\n→ 방향 2\" }\n\n\u002F\u002F Contact (last slide)\n{ isContactSlide: true, section: \"CLOSING\", title: \"감사합니다\",\n  contactEmail: \"email@example.com\", contactLinkedIn: \"linkedin.com\u002Fin\u002F...\",\n  contactPhone: \"010-XXXX-XXXX\" }\n\n\u002F\u002F Punchline (impactful closing)\n{ isPunchlineSlide: true, section: \"\", title: \"핵심 메시지\" }\n\n\u002F\u002F Abbreviation footnotes (optional, any slide type)\n\u002F\u002F Renders as a small wrap-enabled line at the bottom-left of the slide\n\u002F\u002F (shared FootnoteBuilder — runs from initPPT, no per-theme work needed).\n\u002F\u002F Rule: define each abbreviation at its FIRST appearance per PART;\n\u002F\u002F skip divider\u002Fvideo slides and widely known terms (AI, company\u002Fmodel names).\n{ section: \"섹션명\", title: \"슬라이드 제목\", bullets: [\"불릿 1\"],\n  footnotes: [\"SMR: 소형모듈원전(Small Modular Reactor)\", \"EREV: 주행거리 연장형 전동화(Extended-Range Electric Vehicle)\"] }\n```\n\nUse `design_spec.md`'s CSS variables directly. Unify slide rendering through a single `renderSlide(data)` function. Do not hardcode color or font values.\n\n**Theme + Style injection** (from `lecture-profile.md` → `presentation.theme` + `presentation.style`):\n```html\n\u003Chtml lang=\"ko\" data-theme=\"pitch-enhanced\" data-style=\"premium-dark\">\n\u003Clink rel=\"stylesheet\" href=\"..\u002F..\u002Fdocs\u002Fhtml-themes\u002Fstyles\u002Fbase.css\">\n\u003Clink rel=\"stylesheet\" href=\"..\u002F..\u002Fdocs\u002Fhtml-themes\u002Fstyles\u002Fpremium-dark\u002Fstyle.css\">\n```\nAvailable themes: `outline | pitch | pitch-enhanced | vertical | zen`. Available styles: `classic | minimal | visual-heavy | academic | premium-dark`. Defaults: `pitch-enhanced` + `premium-dark`.\n\n> **Deterministic Builder (Task 4 — pending implementation):** A CLI `build-theme-deck.ts` will automate CSS injection, marker replacement, and ppt-engine.js inlining. Once available, html-build will invoke the builder instead of performing these steps manually. The builder handles: theme\u002Fstyle resolution, package validation, INJECT marker replacement, CSS link generation, ppt-engine.js inlining, strict-JSON slideData injection. html-build remains responsible for: slide content generation, image path binding, narration\u002Fauto-advance config assembly, and renderSlide() (template-provided).\n\n**Theme capabilities:**\n- All 5 themes support `visualImage`, `visualTitle`\u002F`visualDisplay` text panels, profile avatars, `contactPhone`, `isPunchlineSlide`, and `footnotes` (abbreviation footnotes via the shared FootnoteBuilder).\n- `pitch` and `pitch-enhanced` use `slide-content` grid (left text + right visual panel) for standard slides.\n- `outline`, `pitch-enhanced`, `zen`, `vertical` use `slide-card` (content + right-panel) for standard slides.\n- `outline`, `pitch-enhanced`, `zen`, `vertical` support PPT features (TOC drawer, transitions, timer, speaker notes, TTS).\n- `pitch` uses its own layout (TOC drawer, no transitions).\n- `visual-heavy` style uses `--slide-bg-image` CSS variable for full-bleed background images.\n\n**Narration and auto-advance config injection** (from `lecture-profile.md` → `narration` + `auto_advance` sections):\nRead the `narration` and `auto_advance` blocks from `lecture-profile.md` and inject two independent config objects into the `initPPT()` call. This bridges lecture profile settings to the runtime NarrationEngine v2.3:\n```javascript\n\u002F\u002F Inject before the DOMContentLoaded listener or alongside initPPT call\nvar narrationConfig = {\n  enabled: true,\n  autoPlay: false,\n  defaultLanguage: 'ko',\n  scriptLanguage: 'ko',\n  languages: ['ko']\n};\nvar autoAdvanceConfig = {\n  enabled: true,\n  startAsAuto: false,\n  interval: 8\n};\ninitPPT({ transition: 'fade', showTimer: true, showThumbnails: false,\n          narration: narrationConfig, autoAdvance: autoAdvanceConfig });\n```\n- `narration.enabled: false` → hides TTS play button, language dropdown, voice selector; disables 'P' keyboard shortcut\n- `narration.autoPlay: true` → auto-starts TTS narration on page load\n- `narration.scriptLanguage` → declares what language the primary `script` field is written in (defaults to `'ko'`); read from `script_language` in lecture-profile.md, falls back to `language` field\n- `auto_advance.enabled: false` → hides auto-advance toggle button; disables 'A' keyboard shortcut\n- `auto_advance.startAsAuto: true` → starts auto-advance timer immediately on page load\n- `auto_advance.interval` → configures the timer interval (seconds) for auto-advance slides\n- `narration.languages` → populates the language dropdown (only languages with scripts in slideData are clickable)\n- If `narration` section is absent, set `narration.enabled: false`. If `auto_advance` section is absent, use defaults (`enabled: true`, `startAsAuto: false`, `interval: 8`)\n- **Backward compatibility**: if the old single `narration.autoAdvance` or `narration.autoAdvanceInterval` fields are present, silently ignore them\n\n**Image paths:** Photos live in the shared pool at `presentations\u002Fassets\u002Fimages\u002F`. Use `..\u002Fassets\u002Fimages\u002F\u003Cslug>.\u003Cext>` (relative from `presentations\u002F\u003Cproject>\u002F`). Slug is the `path` field basename from `image-manifest.json`. No slide-number prefix. Diagrams (SVG\u002FPNG) live in the shared pool at `presentations\u002Fassets\u002Fdiagrams\u002F`. Use `..\u002Fassets\u002Fdiagrams\u002F\u003Cstem>.png` for diagram slides. Paths are auto-rewritten by `gen-visual-images.ts` when run.\n\n**Canonical rebuild order (U-20261105-007):** every rebuild follows build → style patch → video inject — a rebuild silently drops video players and style patches otherwise. `build-theme-deck.ts` runs the video injection itself after a successful build (idempotent, video-less decks untouched); pass `--download-videos` to pre-fetch the deck's YouTube videos into `presentations\u002Fassets\u002Fvideos\u002Fyt-\u003Cid>.mp4` before injection so offline playback binds local files. Re-apply the style patch after every rebuild.\n\n#### Font Parity (PDF ↔ HTML) — mandatory\n\nA deck's typography has ONE source of truth: the font family the PDF engine\nloads from `presentations\u002Fassets\u002Ffonts\u002F` (currently `Pretendard-Regular\u002FBold.ttf`,\nper `gen-slides-pdf.ts` `--font-dir` default). Every HTML build MUST:\n\n1. Embed that same family via `@font-face` from those same TTF files (CSS url\n   relative to the stylesheet's own location) and set it FIRST in `--font-family`.\n2. Keep system-font fallbacks (Noto Sans KR, Apple SD Gothic Neo) as resilience\n   only — they are never the delivered look.\n3. Verify before hand-off: Playwright `document.fonts.check('400 16px \u003CFamily>')`\n   and `document.fonts.check('700 24px \u003CFamily>')` must both be true.\n\nAny typography change (family, weights, font files) updates the PDF engine and\nthe HTML theme\u002Fpatch in the SAME change (spec activity per ADR-0074).\nDesign: `docs\u002Fdesigns\u002F2026-11-10-font-parity-ssot-principle-design.md`; gate\nrecord: `decisions\u002Fgates.yaml` DG-DECK-06 (S10 sample review).\n\n---\n\n### Stage 6: Image Binding\n\nRead `image-manifest.json` and bind downloaded images to matching slideData entries by slide index. For slides where no image was found by the Image Curator:\n- If slide has `image_role: background` → switch to `visualTitle` \u002F `visualDisplay` text panel fallback\n- If slide has `image_role: illustrative` → omit the right panel; switch to full-text layout\n- Never use placeholder or generic images — always use manifest paths or text fallback\n\n**Background image binding** (when `lecture-profile.md` → `background_image.enabled` is true):\n\n1. Read `background_image` config from `lecture-profile.md`\n2. Read the global background image path from `image-manifest.json` → `background_image.path`\n3. Convert to relative path: `..\u002Fassets\u002Fimages\u002F\u003Cslug>.\u003Cext>`\n4. Inject `backgroundImage` field into `slideData` entries based on scope:\n   - `all` → every slide gets `\"backgroundImage\": \"..\u002Fassets\u002Fimages\u002Fbg-deck.jpg\"`\n   - `divider-cover` → only slides where `isTitleSlide`, `isDividerSlide`, or `isPunchline` is true\n   - `individual` → only slides with `image_role: \"background\"` in the manifest\n5. The template's `renderSlide()` reads `data.backgroundImage` and sets `--slide-bg-image` CSS variable (consumed by `visual-heavy\u002Fstyle.css` for full-bleed backgrounds)\n\n---\n\n### Stage 7: Balance Check\n\nSelf-check after generating the HTML:\n\n- [ ] Total slide count matches the plan\n- [ ] Slide counts per chapter are balanced (within ±20%)\n- [ ] No slides with more than 5 bullets\n- [ ] No more than 3 consecutive slides without visuals\n- [ ] No overly long bullets (recommend under 40 chars\u002Fline)\n\nIf any issue, split or merge slides.\n\n---\n\n### Stage 8: Special Pages\n\n- **Speaker intro**: right after the cover (slide 2)\n- **Contact**: last slide\n\nInsert if either is missing. Populate with `instructor` fields from `lecture-profile.md`.\n\n> To open HTML locally: `bunx serve .` → `http:\u002F\u002Flocalhost:3000`\n\n---\n\n## Output Format\n\n`lecture_[topic]_v1.html` — single self-contained HTML file with embedded `const slideData` (strict JSON), theme `data-theme` attribute, base + override CSS links, and `assets\u002Fimages\u002F` (photos) + `assets\u002Fdiagrams\u002F` (SVG\u002FPNG) alongside.\n\n> PDF pipeline note: `scripts\u002Fco-deck\u002Fextract_slidedata.mjs` parses the inline `const slideData = [...]` array via a bracket-depth state machine (not regex, not DOM). The slideData array **MUST be strict JSON** — all keys double-quoted, string values double-quoted, no trailing commas, no JS comments, no single quotes. Non-JSON syntax will break the PDF pipeline.\n>\n> **Encoding**: All output HTML files MUST be UTF-8 without BOM. Verify `\u003Cmeta charset=\"UTF-8\">` is present in `\u003Chead>`. On Korean Windows systems, ensure `chcp 65001` is active before writing files to prevent CP949 corruption of Korean text content.\n\n> **Builder Boundary:** See `agents\u002Fhtml-build.md` \"Builder Boundary\" section for the complete responsibility split between the builder and the html-build agent.\n\n## Related Skills\n\n- `design` — provides `design_spec.md` CSS variables consumed by this skill\n- `image-curator` — produces `image-manifest.json` that maps slide indices to image paths\n- `measure` — next step; consumes the HTML output to extract pixel coordinates\n- `version` — must be called before any HTML file edit\n",{"name":5,"owner":5,"scope":23,"inputs":24,"status":27,"outputs":28,"version":30,"relates_to":31,"description":43,"last_reviewed":44,"prerequisites":45},"co-deck",[25,26],"slide-deck-draft","design-spec","active",[29],"slide-html","1.7.0",[32,35,37,39,41],{"type":33,"skill":34},"follows","pdf-export",{"type":33,"skill":36},"slide-layout-gate",{"type":38,"skill":34},"composes_with",{"type":38,"skill":40},"research",{"type":38,"skill":42},"storyline","Generates HTML slides from slide_deck.md and design_spec.md. Applies theme (data-theme attribute), binds images from image-manifest.json, inserts speaker intro and contact slides, checks balance. Responds to \"make HTML\", \"generate slides\", \"add images\", \"add speaker intro\" (Korean: \"HTML 만들어줘\", \"슬라이드 생성해줘\", \"이미지 넣어줘\", \"강연자 소개 추가해줘\"). Stages 5-8 of the lecture workflow.\n",1794268800000,"design","main","4d0554bdafafff02aa802871e6db3e0dec4f60a5","templates\u002Fco-deck\u002F.gemini\u002Fskills\u002Fhtml-build",9,"https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards","https:\u002F\u002Fgithub.com\u002F5throck","Experienced in digital transformation, enterprise IT, startup acceleration, and business strategy. Focused on building practical systems that connect technolo","2026-11-14 21:22:34",{"source":8,"skillName":5,"commands":55,"prompt":65,"zipAvailable":66},[56,59,62],{"tool":57,"command":58},"npx","npx skills add 5throck\u002Fai-workspace-standards --skill html-build",{"tool":60,"command":61},"bunx","bunx skills add 5throck\u002Fai-workspace-standards --skill html-build",{"tool":63,"command":64},"pnpm","pnpm dlx skills add 5throck\u002Fai-workspace-standards --skill html-build","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-deck\u002F.gemini\u002Fskills\u002Fhtml-build\u002FSKILL.md",true,[],[69,77,82,87,92,97],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":76},"01M7BBJDYHJMGTJYSC37JVWY8S","i18n-layout","Text layout and encoding guidance: character encoding (UTF-8, legacy Korean code pages, BOM hazards), line endings, RTL\u002Fbidi handling, and script-specific font selection (Hangul focus). Use when: encoding is corrupted or mojibake appears, an RTL locale must render correctly, fonts must be chosen for a script, or CRLF\u002FBOM issues surface.","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":78,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":76},"01M7BBJ9XHAAS1AVGKZZ841VBZ","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.hermes\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],{"skillNo":83,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":76},"01M7BBJ5C3X8TKFKG5R9P9P49W","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.gemini\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],{"skillNo":88,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":76},"01M7BBJ1B52X0QMJ2QVBMPJB37","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.codex\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],{"skillNo":93,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":76},"01M7BBHX91BW2Q2R276MRX5AW3","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.claude\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],{"skillNo":98,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":76},"01M7BBHQWGXPSFRWN1PRC2NMMV","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.agents\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[]]