Metadata-Version: 2.4
Name: ai-voiceover-skills
Version: 0.1.5
Summary: AI voiceover, voice cloning and video Agent Skills for Claude Code, Codex and Cursor: faceless Shorts/TikTok, auto captions, screen-recording narration, Remotion narration, hook A/B tests, AI clip maker (Opus Clip alternative), AI dubbing in your own voice, automatic B-roll, and UGC-style video ads with hook x body variants.
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,ugc ads,ai ugc ad generator,video ad maker,tiktok ads,facebook video ads,ad creative variations,ugc video ads,voice-first ugc ad
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 |
| ugc-video-ads | UGC-style video ads for TikTok, Reels, Shorts and Meta without a video model: your agent writes 3-5 hooks and a body, every hook x body is voiced in your own cloned voice and rendered with safe-zone captions, overlays, end card + CTA, a 3 s hook check, an ad-claim lint, 9:16/4:5/1:1 and an Ads Manager manifest |
| 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

**How do I make UGC-style TikTok or Meta ads with AI, without filming?** Install `ugc-video-ads` and ask your agent to "make 3 hook variations of a TikTok ad for my product from these photos". It writes the hooks and body, lints risky claims for free, voices every line in your own cloned voice and renders each hook x body as a captioned ad. Credits: informed by UGC-Factory and ad-video-skills (MIT) and the reel-studio write-up (no code copied).
