Metadata-Version: 2.4
Name: ai-voiceover-skills
Version: 0.1.0
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.
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
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"*.

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