[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7C4GGN8WS5D41JFDNDT1F2P":3,"skill-same:01M7C4GGN8WS5D41JFDNDT1F2P":53},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M7C4GGN8WS5D41JFDNDT1F2P","creating-narrated-videos",null,"Create a narrated video (slide deck + MP3 narration + captioned 1080p MP4) from text files - a transcript script, a timed HTML slide deck and an outline - using free edge-tts for the audio and a headless browser plus ffmpeg for the video. Use when asked to make, script, record, regenerate or fix a video, tutorial, walkthrough, demo, explainer, training lesson, screencast or slide deck for this repository or product. Not for screen recordings of running applications; use recording-demo-videos for those.","QuinntyneBrown\u002Fquinntyne-brown-studio","QuinntyneBrown","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F1749159?v=4","01M7C4DEMVW0A87TDN8PMZTNFG","Quinntyne Brown","01M7C4DENDYX1QYZDN3F0A5ZX0",1,"MIT","https:\u002F\u002Fgithub.com\u002FQuinntyneBrown\u002Fquinntyne-brown-studio\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fcreating-narrated-videos\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: creating-narrated-videos\ndescription: >-\n  Create a narrated video (slide deck + MP3 narration + captioned 1080p MP4)\n  from text files - a transcript script, a timed HTML slide deck and an outline -\n  using free edge-tts for the audio and a headless browser plus ffmpeg for the\n  video. Use when asked to make, script, record, regenerate or fix a video,\n  tutorial, walkthrough, demo, explainer, training lesson, screencast or slide\n  deck for this repository or product. Not for screen recordings of running\n  applications; use recording-demo-videos for those.\n---\n\n# Creating narrated videos\n\nA video is **narration audio + a slide deck timed to it + captions**, all generated from text files checked into one folder. You author three text files; tooling turns them into media.\n\n```\ndocs\u002Fvideos\u002FNN-kebab-topic\u002F\n  script.md      transcript the audio is synthesized from            (you write)\n  slides.html    one \u003Csection> per slide, each cued to a script phrase (you write)\n  README.md      outline: purpose, objectives, assets on screen, run sheet (you write)\n  NN-kebab-topic.mp3   free edge-tts synthesis                        (generated)\n  NN-kebab-topic.mp4   slides rendered to PNG + audio + captions      (generated)\n```\n\nPaths above are the default. If the repo already has a videos\u002Flessons folder or tooling, follow it instead. Large media should go through Git LFS if `.gitattributes` configures it; `.cache\u002F` folders are never committed.\n\nBefore writing, read any existing video in the repo (tone, length, structure) and the code\u002Fdocs the video covers. Every file path, name, number and quote on screen or in the script must be verified against the repository, never recalled.\n\n## Workflow\n\n1. **Scope.** One topic and one audience per video. Pick the next free `NN` and a kebab-case folder. Define the single question or outcome the video delivers. Update an existing video instead of duplicating a topic.\n2. **Research** the source material and note exact paths and short excerpts for slides.\n3. **Write `script.md`** (format below). Default target ~5-10 minutes (~150 words per minute); longer only if asked.\n4. **Write `README.md`** (outline below).\n5. **Write `slides.html`** (structure below), cueing each slide to a verbatim phrase in the script.\n6. **Validate offline** with the repo's audio tool in dry-run mode (script format, word count and estimated duration; edge-tts has no synthesis charge). If no tool exists yet, create the two small tools described under \"Tooling\" before continuing.\n7. **Synthesize audio** with free `edge-tts` (Microsoft Edge online read-aloud). It needs Python, the `edge-tts` package and internet access; no API key, Azure subscription or paid Speech service. Install with `python -m pip install edge-tts` using the same interpreter as the audio tool (`PYTHON` tells the generator which one). Edge is the generator's default engine; the only other engine is offline Piper (`--engine piper`), and there is no Azure engine. Synthesis also writes a timing manifest (per-section and per-paragraph start\u002Fend, in `.cache\u002F`) that the video is synced to. Keep acronyms and code identifiers in a pronunciation lexicon (`pronunciations.json`) as plain-text spoken replacements and check them with a pronunciation test.\n8. **Build the video** (needs Chrome\u002FEdge - `EDGE_PATH` overrides - and ffmpeg with libx264 - `FFMPEG_PATH` overrides):\n   - `--check`: every `data-cue` is found; prints the schedule.\n   - `--slides-only`: renders PNGs to `.cache\u002F\u003Cfolder>\u002F`. View them before encoding; overflowing code, clipped tables and unreadable text are the common failures.\n   - full build: encodes the 1920x1080 MP4 with burned-in captions.\n9. **Verify:** `ffprobe -v error -show_entries format=duration:stream=codec_name,width,height \u003Cmp4>` gives 1920x1080, h264 + audio, duration about equal to the MP3. Spot-check frames at cue times with `ffmpeg -ss \u003Ct> -i \u003Cmp4> -frames:v 1 \u003Cscratch>.png`.\n10. **Register** the video in the folder's index README, if one exists.\n11. **Commit** only the text files and media; no secrets, no `.cache\u002F`.\n\n## `script.md` format\n\n- First line `# NN · Title`.\n- `## Section` headings group narration; synthesize each paragraph separately and keep sections under ~9 minutes of speech.\n- Plain paragraphs and `-` list items are spoken by the narrator. `**Name:** ...` paragraphs for a second speaker (e.g. `**Interviewer:**`, `**Host:**`) use a second voice.\n- `[pause 5s]` on its own line inserts silence.\n- Inline `` `code` `` is allowed and spoken via the pronunciation lexicon.\n- **Not allowed:** tables, fenced code blocks, links, HTML. It must make sense with eyes closed: describe code, don't read it. Spell numbers as they should be spoken when it matters.\n\nSuggested section order (adapt to the topic): untitled intro paragraph (what and why) → the questions\u002Foutcomes → concept sections → how it applies in this repo (exact paths) → the recommended approach in steps → pitfalls → optional Q&A\u002Fpractice → recap (\"things to remember\", then a one-sentence preview of what's next).\n\nVoice: second person, conversational, concrete, opinionated with trade-offs stated aloud. No filler or marketing tone. Time-sensitive facts carry \"as of \u003Cmonth year>\".\n\n## `README.md` (outline) structure\n\n```markdown\n# NN · Title\n\n> **Runtime:** ~N min · **Audience:** ... · **Prerequisites:** ...\n\n**Video:** [NN-topic.mp4](NN-topic.mp4) · [Slides](slides.html) · **Audio:** [NN-topic.mp3](NN-topic.mp3) · [Transcript](script.md)\n\n## Why this video exists\n## Learning objectives     (bulleted \"By the end, the viewer can:\")\n## Key questions           (| Question | What a strong answer includes |)\n## Code \u002F assets on screen (| File | What to show |)\n## Run sheet               (| Time | Segment | Content |, mm:ss-mm:ss summing to the runtime)\n## Demo commands           (exact, copy-pasteable)\n## Pitfalls\n## References              (official docs; no invented URLs)\n```\n\n## `slides.html` structure\n\nUse one shared stylesheet and runtime (`assets\u002Fslides.css`, `assets\u002Fslides.js`) next to the video folders; copy the head and footer of an existing deck. Never inline new global styles.\n\n```html\n\u003C!doctype html>\n\u003Chtml lang=\"en\">\n\u003Chead>\n\u003Cmeta charset=\"utf-8\">\n\u003Cmeta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n\u003Ctitle>Video NN Slides\u003C\u002Ftitle>\n\u003Clink rel=\"stylesheet\" href=\"..\u002Fassets\u002Fslides.css\">\n\u003C\u002Fhead>\n\u003Cbody data-video-number=\"NN\" data-video-title=\"Title\" data-parts=\"Introduction|Concepts|...|Recap\">\n\n\u003Csection id=\"title\" data-part=\"0\">\n  \u003Cdiv class=\"kicker\">Product · Video NN\u003C\u002Fdiv>\n  \u003Ch1>Title\u003C\u002Fh1>\n  \u003Cp class=\"lead\">One-line subtitle\u003C\u002Fp>\n\u003C\u002Fsection>\n\n\u003Csection id=\"concepts\" data-part=\"1\" data-cue=\"Phrase copied verbatim from script.md\">\n  \u003Ch2>Heading\u003C\u002Fh2>\n  \u003Cul>\u003Cli>...\u003C\u002Fli>\u003C\u002Ful>\n\u003C\u002Fsection>\n\n\u003Cscript src=\"..\u002Fassets\u002Fslides.js\">\u003C\u002Fscript>\n\u003C\u002Fbody>\n\u003C\u002Fhtml>\n```\n\nRules:\n\n- **Every slide except the first has a `data-cue`**: a phrase copied *verbatim* from `script.md` (a heading or the start of a sentence), unique in the script, with cues in **narration order**. A slide appears when narration reaches its cue.\n- `data-part` indexes `data-parts` (header label and progress bar); parts line up with `##` sections.\n- Roughly one slide every 20-40 seconds. Cue changes inside a section are estimated from word counts (within a second or two); section boundaries are exact.\n- Slides support the narration, they don't transcribe it: a heading, 3-5 short bullets, a diagram, or a short code excerpt.\n- Code: `\u003Cpre class=\"code\" data-lang=\"cs|ts|json|yaml|sql|sh|md|xml\" data-mark=\"2,5\">` (escape `\u003C`, `>`, `&`); add `tight` for longer excerpts. Keep excerpts to ~16 lines, copied from the real file.\n- Progressive builds: `\u003Ctemplate id=\"x\">` with `class=\"item\"` children, then `\u003Csection data-template=\"x\" data-show=\"3\">` (reveal) or `data-highlight=\"2-4\">` (focus).\n- Reuse existing classes in `slides.css` (e.g. `kicker`, `lead`, `quote`, `muted`, `small`, `cols`, `card`, `file`, `tag`, `steps`, `question`, `recap`). Add a class only if none fits, and check it doesn't change other decks.\n- If no shared stylesheet\u002Fruntime exists, create them first: 1920x1080 slides, one visible at a time, `?slide=N` or hash navigation so the renderer can screenshot each slide, header label and progress bar from `data-parts`.\n\n## Tooling\n\nKeep two small scripts under `tools\u002F` (language of the repo's choice; a .NET single-file app, Node or Python all work):\n\n- **Audio generator** (`tools\u002Fvideo-audio\u002F`): parses `script.md` strictly; `--dry-run` validates and estimates length without network. Otherwise it uses the `edge-tts` Python package or `python -m edge_tts` CLI with plain text per paragraph: a neural narrator voice (e.g. `en-US-AndrewMultilingualNeural`) and a second voice for other speakers (e.g. `en-US-AvaMultilingualNeural`). Check available voices with `python -m edge_tts --list-voices`. Edge does not support custom SSML: apply `pronunciations.json` as spoken text replacements before synthesis, synthesize speaker paragraphs separately, and insert `[pause 5s]` as ffmpeg-generated silence. Normalize clips to a common audio format, measure their actual durations with ffprobe, concatenate clips and silence into the MP3, and write the timing manifest from those durations.\n- **Video builder** (`tools\u002Fvideo-build\u002F`): opens `slides.html` in headless Chrome\u002FEdge, resolves each `data-cue` to a time using the manifest (section boundaries exact, in-section by word count), screenshots each slide at 1920x1080, writes an SRT\u002FASS caption file from the script, and runs ffmpeg (libx264, aac) to produce the MP4 with burned-in captions. Supports `--check` and `--slides-only`.\n\nPrefer an existing equivalent if the repo already has one. With Node tools in the layout above, run from the repo root (Edge is the default engine, so `--engine edge` is optional):\n\n```sh\n# Use the same Python interpreter for installation and the generator.\nexport PYTHON=python3\npython3 -m pip install edge-tts\nnode tools\u002Fvideo-audio\u002Fgenerate-audio.mjs docs\u002Fvideos\u002FNN-kebab-topic --dry-run\nnode tools\u002Fvideo-audio\u002Fgenerate-audio.mjs --say \"\u003Cproduct name>\" --out .cache\u002Fpronunciation-test.wav\nnode tools\u002Fvideo-audio\u002Fgenerate-audio.mjs docs\u002Fvideos\u002FNN-kebab-topic\nnode tools\u002Fvideo-build\u002Fbuild-video.mjs docs\u002Fvideos\u002FNN-kebab-topic --check\nnode tools\u002Fvideo-build\u002Fbuild-video.mjs docs\u002Fvideos\u002FNN-kebab-topic --slides-only\nnode tools\u002Fvideo-build\u002Fbuild-video.mjs docs\u002Fvideos\u002FNN-kebab-topic\n```\n\nIn PowerShell, set the interpreter with `$env:PYTHON = \"python\"` and use `python` in place of `python3`. Replace `NN-kebab-topic` with the actual folder and `\u003Cproduct name>` with a word the narrator must pronounce correctly. `EDGE_VOICE` and `EDGE_VOICE_2` override the narrator and second-speaker voices. For package usage and supported options, see the [edge-tts documentation](https:\u002F\u002Fgithub.com\u002Frany2\u002Fedge-tts). A working implementation of both tools and the shared slide assets, written for one product, is in the [Saturdaze repository](https:\u002F\u002Fgithub.com\u002FQuinntyneBrown\u002Fsaturdaze) under `tools\u002Fvideo-audio\u002F`, `tools\u002Fvideo-build\u002F` and `docs\u002Fvideos\u002Fassets\u002F`; adapt its branding and pronunciation lexicon rather than copying them unchanged.\n\n## Quality checklist\n\n- [ ] Every path, identifier, number and quote checked against the repo.\n- [ ] Audio dry-run clean; estimated length matches the target.\n- [ ] Cue check clean; no slide shorter than ~4 s or longer than ~90 s.\n- [ ] Rendered PNGs reviewed: nothing clipped or overflowing at 1920x1080.\n- [ ] MP4 is 1080p with audio and captions; duration matches the MP3.\n- [ ] Index README updated, if present.\n- [ ] No secrets or `.cache\u002F` files committed; media via LFS if configured.\n\n## When the tooling can't run\n\nBehind a TLS-intercepting proxy, `edge-tts` fails with a certificate error because it trusts only Python's `certifi` bundle, not `SSL_CERT_FILE`; append the proxy CA to the file `python -c \"import certifi; print(certifi.where())\"` prints and retry.\n\nIf `dotnet`\u002FNode\u002FPython, the `edge-tts` package, internet access, a browser or ffmpeg isn't available, still deliver the three text files, run whatever validation is possible, and tell the user precisely which commands remain and what they need. Never fabricate an MP3\u002FMP4 or claim media was built or checked when it wasn't.\n","# Creating narrated videos\n\nA video is **narration audio + a slide deck timed to it + captions**, all generated from text files checked into one folder. You author three text files; tooling turns them into media.\n\n```\ndocs\u002Fvideos\u002FNN-kebab-topic\u002F\n  script.md      transcript the audio is synthesized from            (you write)\n  slides.html    one \u003Csection> per slide, each cued to a script phrase (you write)\n  README.md      outline: purpose, objectives, assets on screen, run sheet (you write)\n  NN-kebab-topic.mp3   free edge-tts synthesis                        (generated)\n  NN-kebab-topic.mp4   slides rendered to PNG + audio + captions      (generated)\n```\n\nPaths above are the default. If the repo already has a videos\u002Flessons folder or tooling, follow it instead. Large media should go through Git LFS if `.gitattributes` configures it; `.cache\u002F` folders are never committed.\n\nBefore writing, read any existing video in the repo (tone, length, structure) and the code\u002Fdocs the video covers. Every file path, name, number and quote on screen or in the script must be verified against the repository, never recalled.\n\n## Workflow\n\n1. **Scope.** One topic and one audience per video. Pick the next free `NN` and a kebab-case folder. Define the single question or outcome the video delivers. Update an existing video instead of duplicating a topic.\n2. **Research** the source material and note exact paths and short excerpts for slides.\n3. **Write `script.md`** (format below). Default target ~5-10 minutes (~150 words per minute); longer only if asked.\n4. **Write `README.md`** (outline below).\n5. **Write `slides.html`** (structure below), cueing each slide to a verbatim phrase in the script.\n6. **Validate offline** with the repo's audio tool in dry-run mode (script format, word count and estimated duration; edge-tts has no synthesis charge). If no tool exists yet, create the two small tools described under \"Tooling\" before continuing.\n7. **Synthesize audio** with free `edge-tts` (Microsoft Edge online read-aloud). It needs Python, the `edge-tts` package and internet access; no API key, Azure subscription or paid Speech service. Install with `python -m pip install edge-tts` using the same interpreter as the audio tool (`PYTHON` tells the generator which one). Edge is the generator's default engine; the only other engine is offline Piper (`--engine piper`), and there is no Azure engine. Synthesis also writes a timing manifest (per-section and per-paragraph start\u002Fend, in `.cache\u002F`) that the video is synced to. Keep acronyms and code identifiers in a pronunciation lexicon (`pronunciations.json`) as plain-text spoken replacements and check them with a pronunciation test.\n8. **Build the video** (needs Chrome\u002FEdge - `EDGE_PATH` overrides - and ffmpeg with libx264 - `FFMPEG_PATH` overrides):\n   - `--check`: every `data-cue` is found; prints the schedule.\n   - `--slides-only`: renders PNGs to `.cache\u002F\u003Cfolder>\u002F`. View them before encoding; overflowing code, clipped tables and unreadable text are the common failures.\n   - full build: encodes the 1920x1080 MP4 with burned-in captions.\n9. **Verify:** `ffprobe -v error -show_entries format=duration:stream=codec_name,width,height \u003Cmp4>` gives 1920x1080, h264 + audio, duration about equal to the MP3. Spot-check frames at cue times with `ffmpeg -ss \u003Ct> -i \u003Cmp4> -frames:v 1 \u003Cscratch>.png`.\n10. **Register** the video in the folder's index README, if one exists.\n11. **Commit** only the text files and media; no secrets, no `.cache\u002F`.\n\n## `script.md` format\n\n- First line `# NN · Title`.\n- `## Section` headings group narration; synthesize each paragraph separately and keep sections under ~9 minutes of speech.\n- Plain paragraphs and `-` list items are spoken by the narrator. `**Name:** ...` paragraphs for a second speaker (e.g. `**Interviewer:**`, `**Host:**`) use a second voice.\n- `[pause 5s]` on its own line inserts silence.\n- Inline `` `code` `` is allowed and spoken via the pronunciation lexicon.\n- **Not allowed:** tables, fenced code blocks, links, HTML. It must make sense with eyes closed: describe code, don't read it. Spell numbers as they should be spoken when it matters.\n\nSuggested section order (adapt to the topic): untitled intro paragraph (what and why) → the questions\u002Foutcomes → concept sections → how it applies in this repo (exact paths) → the recommended approach in steps → pitfalls → optional Q&A\u002Fpractice → recap (\"things to remember\", then a one-sentence preview of what's next).\n\nVoice: second person, conversational, concrete, opinionated with trade-offs stated aloud. No filler or marketing tone. Time-sensitive facts carry \"as of \u003Cmonth year>\".\n\n## `README.md` (outline) structure\n\n```markdown\n# NN · Title\n\n> **Runtime:** ~N min · **Audience:** ... · **Prerequisites:** ...\n\n**Video:** [NN-topic.mp4](NN-topic.mp4) · [Slides](slides.html) · **Audio:** [NN-topic.mp3](NN-topic.mp3) · [Transcript](script.md)\n\n## Why this video exists\n## Learning objectives     (bulleted \"By the end, the viewer can:\")\n## Key questions           (| Question | What a strong answer includes |)\n## Code \u002F assets on screen (| File | What to show |)\n## Run sheet               (| Time | Segment | Content |, mm:ss-mm:ss summing to the runtime)\n## Demo commands           (exact, copy-pasteable)\n## Pitfalls\n## References              (official docs; no invented URLs)\n```\n\n## `slides.html` structure\n\nUse one shared stylesheet and runtime (`assets\u002Fslides.css`, `assets\u002Fslides.js`) next to the video folders; copy the head and footer of an existing deck. Never inline new global styles.\n\n```html\n\u003C!doctype html>\n\u003Chtml lang=\"en\">\n\u003Chead>\n\u003Cmeta charset=\"utf-8\">\n\u003Cmeta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n\u003Ctitle>Video NN Slides\u003C\u002Ftitle>\n\u003Clink rel=\"stylesheet\" href=\"..\u002Fassets\u002Fslides.css\">\n\u003C\u002Fhead>\n\u003Cbody data-video-number=\"NN\" data-video-title=\"Title\" data-parts=\"Introduction|Concepts|...|Recap\">\n\n\u003Csection id=\"title\" data-part=\"0\">\n  \u003Cdiv class=\"kicker\">Product · Video NN\u003C\u002Fdiv>\n  \u003Ch1>Title\u003C\u002Fh1>\n  \u003Cp class=\"lead\">One-line subtitle\u003C\u002Fp>\n\u003C\u002Fsection>\n\n\u003Csection id=\"concepts\" data-part=\"1\" data-cue=\"Phrase copied verbatim from script.md\">\n  \u003Ch2>Heading\u003C\u002Fh2>\n  \u003Cul>\u003Cli>...\u003C\u002Fli>\u003C\u002Ful>\n\u003C\u002Fsection>\n\n\u003Cscript src=\"..\u002Fassets\u002Fslides.js\">\u003C\u002Fscript>\n\u003C\u002Fbody>\n\u003C\u002Fhtml>\n```\n\nRules:\n\n- **Every slide except the first has a `data-cue`**: a phrase copied *verbatim* from `script.md` (a heading or the start of a sentence), unique in the script, with cues in **narration order**. A slide appears when narration reaches its cue.\n- `data-part` indexes `data-parts` (header label and progress bar); parts line up with `##` sections.\n- Roughly one slide every 20-40 seconds. Cue changes inside a section are estimated from word counts (within a second or two); section boundaries are exact.\n- Slides support the narration, they don't transcribe it: a heading, 3-5 short bullets, a diagram, or a short code excerpt.\n- Code: `\u003Cpre class=\"code\" data-lang=\"cs|ts|json|yaml|sql|sh|md|xml\" data-mark=\"2,5\">` (escape `\u003C`, `>`, `&`); add `tight` for longer excerpts. Keep excerpts to ~16 lines, copied from the real file.\n- Progressive builds: `\u003Ctemplate id=\"x\">` with `class=\"item\"` children, then `\u003Csection data-template=\"x\" data-show=\"3\">` (reveal) or `data-highlight=\"2-4\">` (focus).\n- Reuse existing classes in `slides.css` (e.g. `kicker`, `lead`, `quote`, `muted`, `small`, `cols`, `card`, `file`, `tag`, `steps`, `question`, `recap`). Add a class only if none fits, and check it doesn't change other decks.\n- If no shared stylesheet\u002Fruntime exists, create them first: 1920x1080 slides, one visible at a time, `?slide=N` or hash navigation so the renderer can screenshot each slide, header label and progress bar from `data-parts`.\n\n## Tooling\n\nKeep two small scripts under `tools\u002F` (language of the repo's choice; a .NET single-file app, Node or Python all work):\n\n- **Audio generator** (`tools\u002Fvideo-audio\u002F`): parses `script.md` strictly; `--dry-run` validates and estimates length without network. Otherwise it uses the `edge-tts` Python package or `python -m edge_tts` CLI with plain text per paragraph: a neural narrator voice (e.g. `en-US-AndrewMultilingualNeural`) and a second voice for other speakers (e.g. `en-US-AvaMultilingualNeural`). Check available voices with `python -m edge_tts --list-voices`. Edge does not support custom SSML: apply `pronunciations.json` as spoken text replacements before synthesis, synthesize speaker paragraphs separately, and insert `[pause 5s]` as ffmpeg-generated silence. Normalize clips to a common audio format, measure their actual durations with ffprobe, concatenate clips and silence into the MP3, and write the timing manifest from those durations.\n- **Video builder** (`tools\u002Fvideo-build\u002F`): opens `slides.html` in headless Chrome\u002FEdge, resolves each `data-cue` to a time using the manifest (section boundaries exact, in-section by word count), screenshots each slide at 1920x1080, writes an SRT\u002FASS caption file from the script, and runs ffmpeg (libx264, aac) to produce the MP4 with burned-in captions. Supports `--check` and `--slides-only`.\n\nPrefer an existing equivalent if the repo already has one. With Node tools in the layout above, run from the repo root (Edge is the default engine, so `--engine edge` is optional):\n\n```sh\n# Use the same Python interpreter for installation and the generator.\nexport PYTHON=python3\npython3 -m pip install edge-tts\nnode tools\u002Fvideo-audio\u002Fgenerate-audio.mjs docs\u002Fvideos\u002FNN-kebab-topic --dry-run\nnode tools\u002Fvideo-audio\u002Fgenerate-audio.mjs --say \"\u003Cproduct name>\" --out .cache\u002Fpronunciation-test.wav\nnode tools\u002Fvideo-audio\u002Fgenerate-audio.mjs docs\u002Fvideos\u002FNN-kebab-topic\nnode tools\u002Fvideo-build\u002Fbuild-video.mjs docs\u002Fvideos\u002FNN-kebab-topic --check\nnode tools\u002Fvideo-build\u002Fbuild-video.mjs docs\u002Fvideos\u002FNN-kebab-topic --slides-only\nnode tools\u002Fvideo-build\u002Fbuild-video.mjs docs\u002Fvideos\u002FNN-kebab-topic\n```\n\nIn PowerShell, set the interpreter with `$env:PYTHON = \"python\"` and use `python` in place of `python3`. Replace `NN-kebab-topic` with the actual folder and `\u003Cproduct name>` with a word the narrator must pronounce correctly. `EDGE_VOICE` and `EDGE_VOICE_2` override the narrator and second-speaker voices. For package usage and supported options, see the [edge-tts documentation](https:\u002F\u002Fgithub.com\u002Frany2\u002Fedge-tts). A working implementation of both tools and the shared slide assets, written for one product, is in the [Saturdaze repository](https:\u002F\u002Fgithub.com\u002FQuinntyneBrown\u002Fsaturdaze) under `tools\u002Fvideo-audio\u002F`, `tools\u002Fvideo-build\u002F` and `docs\u002Fvideos\u002Fassets\u002F`; adapt its branding and pronunciation lexicon rather than copying them unchanged.\n\n## Quality checklist\n\n- [ ] Every path, identifier, number and quote checked against the repo.\n- [ ] Audio dry-run clean; estimated length matches the target.\n- [ ] Cue check clean; no slide shorter than ~4 s or longer than ~90 s.\n- [ ] Rendered PNGs reviewed: nothing clipped or overflowing at 1920x1080.\n- [ ] MP4 is 1080p with audio and captions; duration matches the MP3.\n- [ ] Index README updated, if present.\n- [ ] No secrets or `.cache\u002F` files committed; media via LFS if configured.\n\n## When the tooling can't run\n\nBehind a TLS-intercepting proxy, `edge-tts` fails with a certificate error because it trusts only Python's `certifi` bundle, not `SSL_CERT_FILE`; append the proxy CA to the file `python -c \"import certifi; print(certifi.where())\"` prints and retry.\n\nIf `dotnet`\u002FNode\u002FPython, the `edge-tts` package, internet access, a browser or ffmpeg isn't available, still deliver the three text files, run whatever validation is possible, and tell the user precisely which commands remain and what they need. Never fabricate an MP3\u002FMP4 or claim media was built or checked when it wasn't.\n",{"name":5,"description":7},"main","0dbacec4955ea8b75622a8b16233d9bd2618e7ed",".claude\u002Fskills\u002Fcreating-narrated-videos",0,"https:\u002F\u002Fgithub.com\u002FQuinntyneBrown\u002Fquinntyne-brown-studio","https:\u002F\u002Fgithub.com\u002FQuinntyneBrown","https:\u002F\u002Fquinntynebrown.com","Microsoft Certified Solutions Developer specializing in C#, ASP.NET Core, TypeScript, Azure, Angular, Web Components, RxJS, SignalR Core & Entity Framework Core","2026-10-19 10:28:28",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add QuinntyneBrown\u002Fquinntyne-brown-studio --skill creating-narrated-videos",{"tool":39,"command":40},"bunx","bunx skills add QuinntyneBrown\u002Fquinntyne-brown-studio --skill creating-narrated-videos",{"tool":42,"command":43},"pnpm","pnpm dlx skills add QuinntyneBrown\u002Fquinntyne-brown-studio --skill creating-narrated-videos","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FQuinntyneBrown\u002Fquinntyne-brown-studio\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fcreating-narrated-videos\u002FSKILL.md",true,[47],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"agents\u002Fopenai.yaml","REFERENCE","参考文档",328,"https:\u002F\u002Fgithub.com\u002FQuinntyneBrown\u002Fquinntyne-brown-studio\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fcreating-narrated-videos\u002Fagents\u002Fopenai.yaml",[54,61,68,75,82,89],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M7C4JA8SJ18P9JERCKVN799X","writing-screen-composition","Create or update docs\u002Fscreen-composition.md, a document that itemizes every page, dialog, notification and shell part from the HTML mocks and lists, for each, the component-library components it shall be composed of plus the UI that must be built locally. Also ensures AGENTS.md has the \"Components library is mandatory (CRITICAL)\" section. Use when the user mentions screen composition, which components a page uses, mapping mocks to a component library, local vs library UI, or before implementing an application against a component library; and whenever docs\u002Fmocks and a component catalogue exist but docs\u002Fscreen-composition.md does not or is out of date.","https:\u002F\u002Fgithub.com\u002FQuinntyneBrown\u002Fquinntyne-brown-studio\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fwriting-screen-composition\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M7C4J46A36085AMSCEKZX3GG","writing-requirements","Create and manage software requirements documents (L1 high-level and L2 detailed with acceptance criteria) in docs\u002Fspecs\u002F. Use this skill whenever the user mentions requirements, specs, specifications, user stories, features to build, acceptance criteria, ATDD, or wants to define what a system should do before coding. Also use when the user says things like 'what should we build', 'let's plan the feature', 'write up what this needs to do', 'define the behavior', or describes functionality they want implemented -- even if they don't explicitly say 'requirements'. If the user is about to start coding a feature and there are no requirements yet, proactively suggest using this skill first. Requirements come before code. Always.","https:\u002F\u002Fgithub.com\u002FQuinntyneBrown\u002Fquinntyne-brown-studio\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fwriting-requirements\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M7C4HWSMCNEE8H922B4W4BT7","writing-html-mocks","Write static HTML mocks in docs\u002Fmocks\u002F for EVERY page, dialog and notification of a product in EVERY state (default, loading, empty, error, invalid, busy, success, no-results, forbidden, stacked...), responsive, light and dark, keyboard-accessible, with real copy and a coverage matrix. Use this skill BEFORE writing any frontend code, component, template, view or page; whenever the user says mock, mockup, wireframe, prototype, UI, UX, screen, layout, dialog, modal, toast, banner, empty\u002Ferror\u002Floading state, \"what should this look like\", \"show me the UI\", or describes a feature with a visible result; and whenever docs\u002Fspecs or docs\u002Fdetailed-designs exist but docs\u002Fmocks does not. Also use it to add missing states to existing mocks. Mocks come before implementation: if asked for frontend code with no mocks, say so and offer this first. Pair with extracting-design-systems to turn finished mocks into docs\u002Fdesign-system\u002F.","https:\u002F\u002Fgithub.com\u002FQuinntyneBrown\u002Fquinntyne-brown-studio\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fwriting-html-mocks\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M7C4HQZ8AM15WF2PHH3G2BGN","writing-feature-prompts","Write a ready-to-run implementation prompt for a feature request or a bug fix in the current repository, save it outside the repository and open it in a text editor (Notepad on Windows). A feature prompt drives mocks, design system, requirements, detailed design, estimate update and incremental acceptance-test-driven implementation end to end without stopping; a bug-fix prompt drives reproduce, root cause, fix and documentation alignment. Use whenever the user asks to \"create a prompt\", \"write a prompt for this feature\" or \"for this bug\", wants a \"prompt to build X\" or \"prompt to fix Y\", or asks to open a prompt in Notepad.","https:\u002F\u002Fgithub.com\u002FQuinntyneBrown\u002Fquinntyne-brown-studio\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fwriting-feature-prompts\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M7C4HJHMY4ESK2M82BXXJNT9","writing-design-documents","Create software design documents and architecture write-ups from existing L1\u002FL2 requirements in docs\u002Fspecs\u002F. Use for detailed designs organized by subsystem and feature, with requirement traceability and rendered PlantUML C4, class, and sequence diagrams in docs\u002Fdetailed-designs\u002F.","https:\u002F\u002Fgithub.com\u002FQuinntyneBrown\u002Fquinntyne-brown-studio\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fwriting-design-documents\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M7C4HAJZ2JQKS09VASR3XM4T","writing-agent-instructions","Writes the agent instruction files a repository needs so coding agents know how to work in it - AGENTS.md plus the CLAUDE.md, GEMINI.md, and .github\u002Fcopilot-instructions.md pointers - generated from a description of what the project shall be, for a project that does not exist yet. Use this whenever someone mentions AGENTS.md, CLAUDE.md, GEMINI.md, copilot-instructions, \"agent instructions\", \"agent context files\", \"coding agent guidance\", or asks to set up, scaffold, bootstrap, or initialise the conventions for a new project or repository. Use it too when someone describes a project they are about to start and wants an agent to follow its conventions, even if they never name any of these files - if they are standing at an empty directory describing what they intend to build, this is the skill.","https:\u002F\u002Fgithub.com\u002FQuinntyneBrown\u002Fquinntyne-brown-studio\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fwriting-agent-instructions\u002FSKILL.md",[],[]]