voicestudio
Installation
SKILL.md
When to use this skill
Use this skill for source-grounded VoiceStudio fit checks, offline repository preflight, approval-gated Electron or backend setup handoff, local voice cloning, text-described voice design, speech generation, transcription, and ASR → translation → TTS → mux dubbing workflows. Treat model weights, tokens, generated files, and remote providers as separate boundaries from the AGPL application.
Instructions
- Run the offline gate first. From the repository root run
python3 .agent-skills/voicestudio/scripts/preflight.py --json; from an installed skill root runpython3 "$SKILLS_ROOT/voicestudio/scripts/preflight.py" --json. It is offline-only and never launches VoiceStudio, invokes upstream tools, reads secrets, downloads weights, or calls a network. - For a checkout, use
--repo PATH --expect-commit 28bf2c7a83b8a64836297340c52a45d716684aed; report missing markers, tool availability, and the fact thatruntime_verifiedremains false. - Select the maintained Electron desktop path. Source setup is
bun install,bun run setup:api, thenbun run dev; the local FastAPI backend defaults to loopback port 3900, with web 3901 and Electron development 3902. Docker is a separate headless backend and binds published container traffic. - Before any install, launch, server/port bind, credential entry, model or weight download, remote API call, analytics enablement, publishing, or destructive uninstall/data deletion, state the exact action, paths, network endpoints, model size/license implications, and obtain approval. Do not answer first-run analytics consent for the user.
- For voice cloning, require documented consent from the speaker for a real person's voice. Refuse impersonation, fraud, unauthorized identity capture, or deceptive disclosure; prefer a consent-verified profile or a designed voice.
- For voice design, use text attributes with an engine that supports design; OmniVoice uses one attribute per category, while some engines accept free-form descriptions. Do not claim that reference-only engines can design voices.
- For dubbing, preserve the local source and output paths, identify ASR/translation/TTS choices, and describe the ASR → translate → synthesize → mux stages. Verify output existence and playback only after an approved runtime run.
- Troubleshoot from
/health,/openapi.json,/models,/models/install/status, backend logs, device/ffmpeg checks, and the pinned docs. Distinguish source evidence from an unverified live result; never call a paid or remote provider implicitly.