# Send Voice.ai: Creator Voiceover Forge to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "voiceai-voiceover-creator", "name": "Voice.ai: Creator Voiceover Forge", "source": "tencent", "type": "skill", "category": "内容创作", "sourceUrl": "https://clawhub.ai/gizmoGremlin/voiceai-voiceover-creator", "canonicalUrl": "https://clawhub.ai/gizmoGremlin/voiceai-voiceover-creator", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/voiceai-voiceover-creator", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=voiceai-voiceover-creator", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "README.md", "SKILL.md", "eslint.config.js", "examples/podcast_script.md", "examples/shorts_script.txt", "examples/youtube_script.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/voiceai-voiceover-creator" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/voiceai-voiceover-creator", "downloadUrl": "https://openagent3.xyz/downloads/voiceai-voiceover-creator", "agentUrl": "https://openagent3.xyz/skills/voiceai-voiceover-creator/agent", "manifestUrl": "https://openagent3.xyz/skills/voiceai-voiceover-creator/agent.json", "briefUrl": "https://openagent3.xyz/skills/voiceai-voiceover-creator/agent.md" } } ``` ## Documentation ### Voice.ai Creator Voiceover Pipeline This skill follows the Agent Skills specification. Turn any script into a publish-ready voiceover — complete with numbered segments, a stitched master, YouTube chapters, SRT captions, and a beautiful review page. Optionally, replace the audio track on an existing video. Built for creators who want studio-quality voiceovers without the studio. Powered by Voice.ai. ### When to use this skill ScenarioWhy it fitsYouTube long-formFull narration with chapter markers and captionsYouTube ShortsQuick hooks with the shortform templatePodcastsConsistent host voice, intro/outro templatesCourse contentProfessional narration for educational videosQuick iterationSmart caching — edit one section, only that segment re-rendersVideo audio replacementDrop AI voiceover onto screen recordings or B-roll ### The one-command workflow Have a script and a video? Turn them into a finished video with AI voiceover in one shot: node voiceai-vo.cjs build \\ --input my-script.md \\ --voice oliver \\ --title "My Video" \\ --video ./my-recording.mp4 \\ --mux This renders the voiceover, stitches the master audio, and drops it onto your video — all in one command. Output: out/my-video/muxed.mp4 — your video with the new voiceover out/my-video/master.wav — the standalone audio out/my-video/review.html — listen and review each segment out/my-video/chapters.txt — YouTube-ready chapter timestamps out/my-video/captions.srt — SRT captions Use --sync pad if the audio is shorter than the video, or --sync trim to cut it to match. ### Requirements Node.js 20+ — runtime (no npm install needed — the CLI is a single bundled file) VOICE_AI_API_KEY — set as environment variable or in a .env file in the skill root. Get a key at voice.ai/dashboard. ffmpeg (optional) — needed for master stitching, MP3 encoding, loudness normalization, and video muxing. The pipeline still produces individual segments, the review page, chapters, and captions without it. ### Configuration The skill reads VOICE_AI_API_KEY from (in order): Environment variable VOICE_AI_API_KEY Environment variable VOICEAI_API_KEY (alternate) .env file in the skill root echo 'VOICE_AI_API_KEY=your-key-here' > .env Use --mock on any command to run the full pipeline without an API key (produces placeholder audio). ### build — Generate a voiceover from a script node voiceai-vo.cjs build \\ --input \\ --voice \\ --title "My Project" \\ [--template youtube|podcast|shortform] \\ [--language en] \\ [--video input.mp4 --mux --sync shortest] \\ [--force] [--mock] What it does: Reads the script and splits it into segments (by ## headings for .md, or by sentence boundaries for .txt) Optionally prepends/appends template intro/outro segments Renders each segment via Voice.ai TTS as a numbered WAV file Stitches a master audio file (if ffmpeg is available) Generates chapters, captions, a review page, and metadata files Optionally muxes the voiceover into an existing video Full options: OptionDescription-i, --input Script file (.txt or .md) — required-v, --voice Voice alias or UUID — required-t, --title Project title (defaults to filename)--template <name>youtube, podcast, or shortform--mode <mode>headings or auto (default: headings for .md)--max-chars <n>Max characters per auto-chunk (default: 1500)--language <code>Language code (default: en)--video <path>Input video for muxing--muxEnable video muxing (requires --video)--sync <policy>shortest, pad, or trim (default: shortest)--forceRe-render all segments (ignore cache)--mockMock mode — no API calls, placeholder audio-o, --out <dir>Custom output directory ### replace-audio — Swap the audio track on a video node voiceai-vo.cjs replace-audio \\ --video ./input.mp4 \\ --audio ./out/my-project/master.wav \\ [--out ./out/my-project/muxed.mp4] \\ [--sync shortest|pad|trim] Requires ffmpeg. If not installed, generates helper shell/PowerShell scripts instead. Sync policyBehaviorshortest (default)Output ends when the shorter track endspadPad audio with silence to match video durationtrimTrim audio to match video duration Video stream is copied without re-encoding (-c:v copy). Audio is encoded as AAC. A mux report is saved alongside the output. Privacy: Video processing is entirely local. Only script text is sent to Voice.ai for TTS. ### voices — List available voices node voiceai-vo.cjs voices [--limit 20] [--query "deep"] [--mock] ### Available voices Use short aliases or full UUIDs with --voice: AliasVoiceGenderStyleellieEllieFYouthful, vibrant vloggeroliverOliverMFriendly BritishlilithLilithFSoft, femininesmoothSmooth Calm VoiceMDeep, smooth narratorcorpseCorpse HusbandMDeep, distinctiveskadiSkadiFAnime characterzhongliZhongliMDeep, authoritativefloraFloraFCheerful, high pitchchiefMaster ChiefMHeroic, commanding The voices command also returns any additional voices available on the API. Voice list is cached for 10 minutes. ### Build outputs After a build, the output directory contains: out/<title-slug>/ segments/ # Numbered WAV files (001-intro.wav, 002-section.wav, …) master.wav # Stitched audio (requires ffmpeg) master.mp3 # MP3 encode (requires ffmpeg) manifest.json # Build metadata: voice, template, segment list, hashes timeline.json # Segment durations and start times review.html # Interactive review page with audio players chapters.txt # YouTube-friendly chapter timestamps captions.srt # SRT captions using segment boundaries description.txt # YouTube description with chapters + Voice.ai credit ### review.html A standalone HTML page with: Master audio player (if stitched) Individual segment players with titles and durations Collapsible script text for each segment Regeneration command hints ### Templates Templates auto-inject intro/outro segments around the script content: TemplatePrependsAppendsyoutubetemplates/youtube_intro.txttemplates/youtube_outro.txtpodcasttemplates/podcast_intro.txt—shortformtemplates/shortform_hook.txt— Edit the files in templates/ to customize the intro/outro text. ### Caching Segments are cached by a hash of: text content + voice ID + language. Unchanged segments are skipped on rebuild — fast iteration Modified segments are re-rendered automatically Use --force to re-render everything Cache manifest is stored in segments/.cache.json ### Multilingual support Voice.ai supports 11 languages. Use --language <code> to switch: en, es, fr, de, it, pt, pl, ru, nl, sv, ca The pipeline auto-selects the multilingual TTS model for non-English languages. ### Troubleshooting IssueSolutionffmpeg missingPipeline still works — you get segments, review page, chapters, captions. Install ffmpeg for master stitching and video muxing.Rate limits (429)Segments render sequentially, which stays under most limits. Wait and retry.Insufficient credits (402)Top up at voice.ai/dashboard. Cached segments won't re-use credits on retry.Long scriptsCaching makes rebuilds fast. Text over 490 chars per segment is automatically split across API calls.Windows pathsWrap paths with spaces in quotes: --input "C:\\My Scripts\\script.md" See references/TROUBLESHOOTING.md for more. ### References Agent Skills Specification Voice.ai references/VOICEAI_API.md — API endpoints, audio formats, models references/TROUBLESHOOTING.md — Common issues and fixes ## Trust - Source: tencent - Verification: Indexed source record - Publisher: gizmoGremlin - Version: 0.1.3 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-30T16:55:25.780Z - Expires at: 2026-05-07T16:55:25.780Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/voiceai-voiceover-creator) - [Send to Agent page](https://openagent3.xyz/skills/voiceai-voiceover-creator/agent) - [JSON manifest](https://openagent3.xyz/skills/voiceai-voiceover-creator/agent.json) - [Markdown brief](https://openagent3.xyz/skills/voiceai-voiceover-creator/agent.md) - [Download page](https://openagent3.xyz/downloads/voiceai-voiceover-creator)