Document to Narration
Convert written documents to narrated video scripts with TTS audio and word-level timing. Use when preparing essays, blog posts, or articles for video narration. Outputs scene files, audio, and VTT with precise word timestamps. Keywords: narration, voiceover, TTS, scenes, audio, timing, video script, spoken.
Install
npx skills add jwynia/agent-skills --skill document-to-narrationgit clone --depth 1 https://github.com/jwynia/agent-skills.git /tmp/agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/agent-skills/skills/education/document-to-narration ~/.claude/skills/document-to-narrationPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# 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 There are two approaches: **per-scene** (legacy) and **full narration** (recommended). ### Full Narration Pipeline (Recommended) Generates a single audio file for consistent volume and pacing:
Details
- Skill name
document-to-narration- Repository
- jwynia/agent-skills
- Path
skills/education/document-to-narration/SKILL.md- Repo updated
- 24 February 2026
FAQ
What does the Document to Narration skill do?
Convert written documents to narrated video scripts with TTS audio and word-level timing. Use when preparing essays, blog posts, or articles for video narration. Outputs scene files, audio, and VTT with precise word timestamps. Keywords: narration, voiceover, TTS, scenes, audio, timing, video script, spoken.
How do I install the Document to Narration skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add jwynia/agent-skills --skill document-to-narration. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Document to Narration popular?
It lives in jwynia/agent-skills, which has 191 GitHub stars and 24 forks.
Related skills
Abstract Strategy
191jwynia/agent-skills
Design abstract strategy games with perfect information, no randomness, and strategic depth. Use when designing a board game, exploring abstract strategy games, brainstorming game mechanics, or evaluating game balance. Keywords: board game, game design, strategy, mechanics, balance.
Adaptation Synthesis
191jwynia/agent-skills
Synthesize new works from extracted functional DNA documents. Use when adapting a source work to a new context, when combining multiple source extractions, or when generating variations that preserve function while changing form.
Agent Bootstrap
191jwynia/agent-skills
Bootstrap agentic development environment from agent.toml manifest
Download Video
201swyxio/skills
Downloads embedded videos from web pages. Fetches the page, identifies the video hosting service (Vimeo, YouTube, etc.), resolves the correct embed/player URL, and downloads using yt-dlp. Handles private/unlisted videos that require referer headers or embed URLs. Use this skill when someone says "download this video", "save this video", "grab the video from this page", "rip this video", or provides a URL and asks to download media from it. Also trigger when someone pastes a URL to a page with an embedded video and wants the video file locally.
Dialogue
191jwynia/agent-skills
Diagnose flat dialogue, same-voice characters, and lack of subtext. Use when conversations feel wooden, characters sound alike, or dialogue only does one thing at a time.
Download X Video
201swyxio/skills
Download video from X/Twitter posts using yt-dlp. Use when the user wants to "download this X video", "save this tweet video", "grab video from Twitter", or provides an x.com/twitter.com status URL with a video. Handles HLS streams and uses --print after_move:filepath for reliable path detection.
Browse the most popular Claude skills, all images, video & audio skills, or write your own with the skills generator.