Skip to content

onimusya/media-gen / skills/media-generation

media-generation

Unverified

Generate and edit images, create videos and music, synthesize speech, transcribe and translate audio using multiple AI providers (OpenAI, Google, ElevenLabs, Deepgram, Fal, Luma, Replicate, Stability, Runway, OpenRouter, Edge TTS). Use when the user asks to create media assets, generate pictures, make videos or music, produce voiceovers, transcribe recordings, or work with any visual/audio content.

Media Generation

Run the CLI at ${CLAUDE_SKILL_DIR}/scripts/media-gen.mjs with Node.js. Always use --json for parseable output.

node ${CLAUDE_SKILL_DIR}/scripts/media-gen.mjs <command> [options] --json

Commands

CommandPurpose
image generateGenerate images from text prompts
image editEdit existing images with a prompt
video generateGenerate video from text (async)
video image-to-videoAnimate an image into video
video extendExtend an existing video
music generateGenerate an MP3 from a text prompt
voice ttsText to speech synthesis
voice cloneClone a voice from audio samples
voice isolateIsolate voice from background audio
audio transcribeTranscribe audio to text
audio translateTranslate audio to another language
providers listList all providers with capabilities, models, and voices
providers list --configuredList only configured providers
providers list --capability <cap>Filter by capability
providers modelsList all models across all providers
providers models --provider <id>List models/voices for a specific provider
providers models --capability <cap>Filter models by capability
config initInitialize project-level config
config init --globalInitialize user-level config at ~/.media-gen/
config validateCheck which providers are configured
job statusCheck async job status
job downloadDownload completed async job result

Configuration

Defaults are set via .env (at project root or ~/.media-gen/.env for global). With defaults configured, --provider, --model, and --voice-id are all optional:

MEDIA_GEN_DEFAULT_PROVIDER=openrouter
MEDIA_GEN_DEFAULT_MODEL=openai/gpt-image-2
MEDIA_GEN_VOICE_PROVIDER=edge-tts
MEDIA_GEN_VOICE_MODEL=
MEDIA_GEN_VOICE_ID=en-US-EmmaMultilingualNeural
MEDIA_GEN_VIDEO_PROVIDER=google
MEDIA_GEN_VIDEO_MODEL=gemini-omni-1.2-flash
MEDIA_GEN_AUDIO_PROVIDER=deepgram
MEDIA_GEN_AUDIO_MODEL=nova-3
MEDIA_GEN_MUSIC_PROVIDER=google
MEDIA_GEN_MUSIC_MODEL=
MEDIA_GEN_LOG_LEVEL=error

Examples

Image generation

node ${CLAUDE_SKILL_DIR}/scripts/media-gen.mjs image generate \
  --prompt "A pixel art fantasy arena" \
  --output ./outputs/arena.png \
  --json

Video generation (wait for result)

node ${CLAUDE_SKILL_DIR}/scripts/media-gen.mjs video generate \
  --provider google \
  --model gemini-omni-1.2-flash \
  --prompt "A cinematic card pack opening" \
  --duration 8 \
  --output ./outputs/video.mp4 \
  --wait \
  --json

Music generation

node ${CLAUDE_SKILL_DIR}/scripts/media-gen.mjs music generate --provider google --prompt "Gentle orchestral piano" --instrumental --output ./outputs/lyria.mp3 --json
node ${CLAUDE_SKILL_DIR}/scripts/media-gen.mjs music generate --provider elevenlabs --prompt "Bright acoustic bossa nova" --duration 15 --instrumental --output ./outputs/eleven.mp3 --json

Google defaults to lyria-3.5 and treats length and instrumental options as prompt guidance. ElevenLabs defaults to music_v2_5 and accepts 3 to 600 seconds.

Text to speech (Edge TTS - free, no API key)

node ${CLAUDE_SKILL_DIR}/scripts/media-gen.mjs voice tts \
  --provider edge-tts \
  --voice-id en-US-EmmaMultilingualNeural \
  --text "Hello world" \
  --output ./outputs/voice.mp3 \
  --json

Text to speech (ElevenLabs)

node ${CLAUDE_SKILL_DIR}/scripts/media-gen.mjs voice tts \
  --provider elevenlabs \
  --voice-id JBFqnCBsd6RMkjVDRZzb \
  --text "Welcome to the show" \
  --output ./outputs/george.mp3 \
  --json

Text to speech (Google Gemini TTS)

node ${CLAUDE_SKILL_DIR}/scripts/media-gen.mjs voice tts \
  --provider google \
  --model gemini-3.1-flash-tts-preview \
  --voice-id Kore \
  --text "Say cheerfully: Have a wonderful day!" \
  --output ./outputs/gemini-voice.wav \
  --json

Text to speech (OpenAI)

node ${CLAUDE_SKILL_DIR}/scripts/media-gen.mjs voice tts \
  --provider openai \
  --model gpt-4o-mini-tts \
  --voice-id coral \
  --text "Hello from OpenAI" \
  --output ./outputs/openai-voice.mp3 \
  --json

Text to speech (with defaults set, minimal)

node ${CLAUDE_SKILL_DIR}/scripts/media-gen.mjs voice tts \
  --text "Just provide text when defaults are configured" \
  --output ./outputs/speech.mp3 \
  --json

Transcription

node ${CLAUDE_SKILL_DIR}/scripts/media-gen.mjs audio transcribe \
  --input ./audio/recording.mp3 \
  --output ./outputs/transcript.json \
  --json

List supported providers and models

node ${CLAUDE_SKILL_DIR}/scripts/media-gen.mjs providers list --json

List voices for a TTS provider

node ${CLAUDE_SKILL_DIR}/scripts/media-gen.mjs providers models --provider edge-tts --json
node ${CLAUDE_SKILL_DIR}/scripts/media-gen.mjs providers models --provider elevenlabs --json
node ${CLAUDE_SKILL_DIR}/scripts/media-gen.mjs providers models --provider openai --json
node ${CLAUDE_SKILL_DIR}/scripts/media-gen.mjs providers models --provider google --json

Dry run (validate without calling API)

node ${CLAUDE_SKILL_DIR}/scripts/media-gen.mjs image generate \
  --prompt "test" --dry-run --json

Async Video Jobs

OpenRouter, Luma, Runway, fal and Replicate return video job IDs. Google Omni returns the completed video file synchronously, including without --wait.

Pattern 1: Wait for completion (simple)

Add --wait to block until the video is ready:

node ${CLAUDE_SKILL_DIR}/scripts/media-gen.mjs video generate \
  --provider openrouter \
  --model google/veo-3.1 \
  --prompt "A cinematic scene" \
  --output ./outputs/video.mp4 \
  --wait \
  --poll-interval 5000 \
  --timeout 300000 \
  --json

Returns the final file path when complete.

Pattern 2: Non-blocking (get job ID, check later)

Without --wait, the CLI returns immediately with a job ID:

# Start generation (returns instantly)
node ${CLAUDE_SKILL_DIR}/scripts/media-gen.mjs video generate \
  --provider openrouter \
  --model google/veo-3.1 \
  --prompt "A cinematic scene" \
  --json
# Returns: {"ok": true, "jobId": "YOUR_JOB_ID", "status": "processing"}

# Check status later
node ${CLAUDE_SKILL_DIR}/scripts/media-gen.mjs job status \
  --provider openrouter \
  --job-id "YOUR_JOB_ID" \
  --json
# Returns: {"ok": true, "jobId": "...", "status": "completed"}

# Download the result
node ${CLAUDE_SKILL_DIR}/scripts/media-gen.mjs job download \
  --provider openrouter \
  --job-id "YOUR_JOB_ID" \
  --output ./outputs/video.mp4 \
  --json

Async options

OptionDefaultDescription
--waitfalseBlock until job completes
--poll-interval5000Milliseconds between status checks
--timeout600000Max wait time (10 minutes)

Async providers

OpenRouter, Luma AI, Runway, Fal.ai, and Replicate use async for video. Google Omni returns the completed video synchronously. Image and TTS are always synchronous.

Response format

Success:

{"ok": true, "type": "image", "provider": "openai", "model": "gpt-image-2", "outputFile": "./outputs/image.png", "durationMs": 1200}

Error:

{"ok": false, "error": {"code": "PROVIDER_NOT_CONFIGURED", "message": "Missing OPENAI_API_KEY", "suggestion": "Set OPENAI_API_KEY in .env"}}

Rules

  • Use --json for all calls.
  • Use --dry-run before expensive operations when unsure.
  • Never use --overwrite unless the user confirms.
  • Keep outputs inside the project workspace.
  • For video, use --wait only when the user wants the file immediately.
  • Check the ok field in every response before proceeding.
  • On error, show the suggestion field to the user.
  • For TTS, --voice-id is optional when MEDIA_GEN_VOICE_ID is set in .env.
  • Edge TTS is free and requires no API key — prefer it for basic TTS tasks.

Provider Capabilities

ProviderImageVideoTTSTranscribeTranslateCloneIsolateMusic
openaiYesYesYesYes
googleYesYesYesYes
azureYesYesYesYes
elevenlabsYesYesYesYes
deepgramYesYesYes
falYesYes
lumaYes
replicateYesYes
stabilityYes
runwayYes
openrouterYesYes
edge-ttsYes (free)
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall