gooseworks-ai/goose-skills / skills/video/create-vo-elevenlabs
create-vo-elevenlabs
VerifiedGenerate a voiceover (VO) clip via ElevenLabs text-to-speech, routed through the GooseWorks proxy, so the call is charged to your GooseWorks credits. Voice id + script text come from the template recipe. Use for the spoken narration of VO-driven video-ad formats (cgi-app-sizzle, flat-vector-explainer, hypermotion). Never call ElevenLabs directly — the proxy attribution is required.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.9 KB |
| scripts/gen_vo.py | script | 12.1 KB |
| scripts/media_proxy.py | script | 56.8 KB |
| scripts/read_pronunciations.py | script | 3.7 KB |
| skill.meta.json | config | 221 B |
| tests/smoke-test.md | markdown | 98 B |
| tests/test_gen_vo.py | script | 1.0 KB |
| tests/test_pace.py | script | 4.1 KB |
| tests/test_timestamps.py | script | 3.3 KB |
tests/test_timestamps.py
View on GitHub"""Timestamped TTS uses the same billing transport and saves usable alignment."""
import base64
import json
from pathlib import Path
import sys
import tempfile
import unittest
from unittest import mock
sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "scripts"))
from gen_vo import timestamped_tts
class TimestampTests(unittest.TestCase):
def setUp(self):
self.tmp = tempfile.TemporaryDirectory()
self.addCleanup(self.tmp.cleanup)
self.out = Path(self.tmp.name) / "nested/beat-01.mp3"
self.alignment = {"characters": ["h", "i"],
"character_start_times_seconds": [0, .2],
"character_end_times_seconds": [.2, .4]}
self.proxy = mock.Mock()
self.proxy.relay_mode.return_value = False
self.proxy._cfg.return_value = ("https://example.test", "test-token", "test-agent")
self.proxy._params.return_value = {"agent": "test-agent"}
self.proxy.requests.post.return_value.json.return_value = {
"audio_base64": base64.b64encode(b"test-audio").decode(), "alignment": self.alignment}
def test_http_preserves_voice_model_settings_and_writes_caption_sidecar(self):
settings = {"speed": .92, "stability": .4}
timestamped_tts("hi", "voice-a", self.out, "eleven_multilingual_v2", settings, self.proxy)
args, kwargs = self.proxy.requests.post.call_args
self.assertEqual(args[0], "https://example.test/api/internal/elevenlabs-proxy/v1/text-to-speech/voice-a/with-timestamps")
self.assertEqual(kwargs["json"], {"text": "hi", "model_id": "eleven_multilingual_v2", "voice_settings": settings})
self.assertEqual(self.out.read_bytes(), b"test-audio")
self.assertEqual(json.loads(self.out.with_suffix(".timestamps.json").read_text()), self.alignment)
def test_relay_uses_returned_download_and_alignment(self):
self.proxy.relay_mode.return_value = True
self.proxy._relay.return_value = {"download_url": "https://example.test/audio", "alignment": self.alignment}
# The real download writes the file; the provenance sidecar hashes those bytes.
self.proxy.download.side_effect = lambda url, path: Path(path).write_bytes(b"relay-audio")
timestamped_tts("hi", "voice-a", self.out, "eleven_multilingual_v2", proxy=self.proxy)
self.proxy.download.assert_called_once_with("https://example.test/audio", str(self.out))
self.proxy.requests.post.assert_not_called()
self.assertTrue(self.out.with_suffix(".timestamps.json").exists())
self.assertEqual(json.loads(self.out.with_suffix(".provenance.json").read_text())["content_review_status"], "pending")
def test_missing_or_malformed_alignment_writes_no_completed_audio(self):
for alignment in ({}, {"characters": ["h"], "character_start_times_seconds": [], "character_end_times_seconds": []}):
self.proxy.requests.post.return_value.json.return_value = {
"audio_base64": base64.b64encode(b"audio").decode(), "alignment": alignment}
with self.assertRaisesRegex(RuntimeError, "no usable character timings"):
timestamped_tts("hi", "voice-a", self.out, "eleven_multilingual_v2", proxy=self.proxy)
self.assertFalse(self.out.exists())
if __name__ == "__main__":
unittest.main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |