jwynia avatar

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-code

Installs 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
1laravel avatartailwindcss-developmentlaravel/boostAlways invoke when the user's message includes 'tailwind' in any form. Also invoke for: building responsive grid layouts (multi-column card grids, product grids992skills.sh installs
2ailabs-393 avatartech-debt-analyzerailabs-393/ai-labs-claude-skillsThis skill should be used when analyzing technical debt in a codebase, documenting code quality issues, creating technical debt registers, or assessing code mai988skills.sh installs
3davila7 avataragile-product-ownerdavila7/claude-code-templatesAgile product ownership toolkit for Senior Product Owner including INVEST-compliant user story generation, sprint planning, backlog management, and velocity tra987skills.sh installs
4tencentcloudbase avatarhttp-api-cloudbasetencentcloudbase/skillsCloudBase official HTTP API client guide. This skill should be used when backends, scripts, or non-SDK clients must call CloudBase platform APIs over raw HTTP i982skills.sh installs
5thienanblog avatarlaravel-11-12-app-guidelinesthienanblog/awesome-ai-agent-skillsGuidelines and workflow for working on Laravel 11 or Laravel 12 applications across common stacks (API-only or full-stack), including optional Docker Compose/Sa980skills.sh installs
6tencentcloudbase avatarrelational-database-mcp-cloudbasetencentcloudbase/skills[Deprecated] This is the required documentation for agents operating on the CloudBase Relational Database through MCP. It defines the canonical SQL management f960skills.sh installs