
Document To Narration
This converts written documents into TTS narration with word-level timing for video production. It splits your markdown into natural scene breaks based on argument flow rather than just heading structure, generates audio using a local Qwen3-TTS model, then transcribes with Whisper to get precise word timestamps for captions. The full narration pipeline is smarter than the legacy per-scene approach because it avoids volume jumps between concatenated clips. You get scene text files, WAV audio, VTT captions, and timing boundaries ready for video composition. Requires a chunky local setup with Deno, Python 3.12, ffmpeg, and a 7.8GB TTS model, so this is for people already committed to local TTS workflows who need that granular timing data.
- skills.sh installs
- 994
- GitHub stars
- 182
- last updated
- Aug 21, 2026
Install
$ npx -y skills add jwynia/agent-skills --skill document-to-narration --agent claude-codeInstalls into .claude/skills of the current project.
Files
Document to Narration
Convert written documents into narrated video scripts with precise word-level timing.
Core Principle
The agent interprets; the document guides. Rather than rigid template-based splits, this skill uses agent judgment to find where the content naturally breathes, argues, and transitions. The document's argument flow determines scene breaks, not a predetermined structure.
When to Use This Skill
Use this skill when:
- Converting a blog post or essay to video narration
- Preparing content for TTS audio generation
- Breaking long-form content into digestible scenes
- Creating word-level synchronized captions for video
Do NOT use this skill when:
- The content is already in scene/script format
- You need real-time voice synthesis (this is batch processing)
- Working with dialogue or multi-speaker content (single voice only)
Prerequisites
- Deno installed (https://deno.land/)
- Python 3.12 with venv support
- ffmpeg for audio conversion
- whisper-cpp (installed via @remotion/install-whisper-cpp)
- TTS model at
tts/model/(not in git due to size - see Model Setup below)
Complete Pipeline
Sponsors
Details
- Repository
- github.com/jwynia/agent-skills
- Categories
- Documentation, AI & Agent Building, Automation & Workflows, Office & Documents, Generative Media, Video & Audio Editing
- First seen
- Jun 3, 2026
More from jwynia/agent-skills
All 118- Pdf Generator921
- Story Coach895
- Electron Best Practices863
- Web Search780
- Fact Check771
- Worldbuilding753
- Docx Generator736
- Joke Engineering727
- Summarization719
- Story Analysis699
- Dialogue692
- Novel Revision691
- Story Idea Generator679
- Story Sense659
- System Design656
- Systemic Worldbuilding640
- Skill Builder630
- Character Arc629
- Story Collaborator620
- Typescript Best Practices616
- Task Decomposition599
- Interactive Fiction587
- Musical Dna564
- Prose Style564