Metadata-Version: 2.4
Name: ai-voiceover-skills
Version: 0.1.1
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, and an AI clip maker that turns long videos into YouTube Shorts (open-source Opus Clip alternative).
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
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 |
| 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 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
