Communitygithub.com

Sanidhya14321/video-forge

Generate local or optional OpenAI narration, prepare music and sound effects, and mix audio for technical videos.

What is video-forge?

video-forge is a Codex agent skill that generate local or optional OpenAI narration, prepare music and sound effects, and mix audio for technical videos.

Works with~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Sanidhya14321/video-forge/tree/HEAD/skills/video-audio

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Video Audio

Read audio workflows. Prefer approved audio or local Kokoro. Verify pronunciation of symbols, names, abbreviations, and code before the full export. A script that reads well may not speak well.

Use narration.provider: file for supplied audio, kokoro for local synthesis, or openai for an explicitly selected paid speech call. OpenAI requires a verified per-character rate and a cloud reservation budget; supported models are documented in the project contract. Credentials belong in environment variables.

The runner rejects narration longer than the scene timeline. Short narration leaves the remaining visual duration intact. Music loops at the configured volume and is attenuated while timestamped caption words are active. Generated voice receives measured two-pass loudness normalization before mixing. Supplied voice levels are preserved. Inspect actual audio and avoid claiming a loudness target that was not measured.

Generated narration must be disclosed in publishing copy. Custom voice cloning and hosted music generation are reference workflows. Preserve audio credits separately from the toolkit's code license.

For beat-driven reels, follow reel direction. Derive cue times from the same FPS/BPM clock as motion, accent important transformations selectively, and preserve voice intelligibility. Do not import a trending commercial track without a usable license.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Related Skills