Metadata-Version: 2.4
Name: ai-voiceover-skills
Version: 0.1.3
Summary: AI voiceover, voice cloning and auto-caption Agent Skills for Claude Code, Codex and Cursor: add voiceover to video, faceless Shorts/TikTok, screen-recording narration, Remotion narration, A/B hook voiceovers, an AI clip maker that turns long videos into YouTube Shorts (open-source Opus Clip alternative), AI video dubbing / video translation in your own cloned voice, and automatic B-roll cut on the spoken word (MP4 + EDL for Premiere/Resolve).
Author: HeadVox
License: MIT
Project-URL: Homepage, https://github.com/yyert123/miragea-skills
Project-URL: Source, https://github.com/yyert123/miragea-skills
Project-URL: Demo, https://huggingface.co/spaces/headvox/miragea-skills
Project-URL: Voice engine, https://miragea.ai
Keywords: ai voiceover,text to speech,voice cloning,ai voice generator,add voiceover to video,auto captions,subtitles,faceless youtube,tiktok voiceover,youtube shorts,claude skills,agent skills,claude code,remotion,screen recording voiceover,ai clip maker,opus clip alternative,video to shorts,youtube shorts maker,ai video editor,podcast clips,subtitle generator,ai dubbing,video translator,dub video in my voice,video translation,elevenlabs dubbing alternative,youtube multi-language audio,own-voice dubbing,auto b-roll,ai b-roll generator,b-roll for talking head,automatic b-roll,cutaway footage,faceless video with b-roll,edl export
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Classifier: Topic :: Multimedia :: Video
Classifier: Intended Audience :: Developers
Classifier: Environment :: Console
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# ai-voiceover-skills

**AI voiceover, voice cloning and auto-caption skills for AI coding agents** (Claude Code, OpenAI Codex, Cursor, any Agent Skills client). Install once, then just ask your agent: *"add a voiceover to demo.mp4"*, *"turn this script into a TikTok"*, *"caption this video"*, *"make 5 Shorts from this podcast"*.

```bash
pip install ai-voiceover-skills
ai-voiceover-skills list
ai-voiceover-skills install            # all skills -> ~/.claude/skills
ai-voiceover-skills install --agent codex shorts-voiceover
export MIRAGEA_API_KEY=...             # voice + speech recognition engine
```

| Skill | What it does |
|---|---|
| video-to-shorts | AI clip maker / Opus Clip alternative: long video or podcast to captioned 9:16 Shorts, TikToks and Reels, sentence-safe cuts, optional spoken hook in your cloned voice |
| video-dubbing | AI dubbing / video translator in your own cloned voice: agent-written translation fitted to each line's time budget, lines start on the original, max 1.2x speed-up, translated SRT, full-length track for YouTube multi-language audio |
| auto-broll | Automatic B-roll on the exact spoken word for talking-head videos, podcasts and tutorials: your agent picks the cutaways, cuts land on the word, speaker audio untouched, editorial checks, MP4 + CMX 3600 EDL for Premiere / Resolve; own clips or free Pexels stock; faceless mode voices a script in your cloned voice |
| hook-variants | A/B test the first 3 seconds: voice 4-6 opening hooks in the same AI voice, trimmed, -14 LUFS, measured length |
| shorts-voiceover | Script to a finished 1080x1920 YouTube Short / TikTok / Reel with voiceover and speech-timed captions |
| screen-recording-voiceover | Add AI narration to a silent screen recording, each line synced to its step |
| video-captions | Auto captions / subtitles (SRT, VTT, burned-in, TikTok style) from the real speech |
| remotion-narration | Per-scene voiceover, durations and captions for Remotion videos |

## FAQ
**How do I add B-roll to a talking-head video automatically?** Install `auto-broll` and ask your agent to "add B-roll to talk.mp4 from my broll folder". It transcribes once, picks a cutaway for each concrete moment, lands every cut on its word and exports the MP4 plus an EDL for Premiere or DaVinci Resolve. Credits: informed by motion-broll, b-roll-finder, cut-as-code and erduo-broll-loop-engineering (no code copied).

**How do I dub a video into another language in my own voice?** Install `video-dubbing` and ask your agent to "dub talk.mp4 into Spanish". It transcribes once, translates each line within its time budget, voices it in your cloned voice and exports the dubbed MP4, SRT and a YouTube audio track. Credits: inspired by VideoLingo, pyVideoTrans and KrillinAI (no code copied).

**How do I turn a long video into YouTube Shorts with AI?** Install `video-to-shorts` and ask your agent to "make 5 Shorts from talk.mp4". It transcribes once, picks moments from the timestamped transcript, and renders captioned 1080x1920 clips; no extra LLM key or GPU.

**How do I add AI voiceover to a video with Claude Code?** Install the skills, set `MIRAGEA_API_KEY`, and ask Claude to add a voiceover. It runs the right script for you.

**Can it use my own voice?** Yes. Use a saved voice id or a public clip of your own voice (voice cloning). Only clone voices you own or may use.

**GPU needed?** No. Scripts are standard-library Python plus ffmpeg; voice and speech recognition run on the [Miragea](https://miragea.ai) API.

Source, demos and full docs: https://github.com/yyert123/miragea-skills · Live demo: https://huggingface.co/spaces/headvox/miragea-skills
