spatial9-immersive-mix/SKILL.md

SKILL.md: full Markdown source from the spatial9-immersive-mix folder of Spatial9 Agent Skills. Free, MIT licensed code for immersive audio with the Spatial9...

Raw file · View on GitHub · Download every file as a zip

Spatial9 immersive mix

Requires the Spatial9 MCP server: https://spatial9.ai/mcp (sign in with OAuth or send Authorization: Bearer s9_...), or https://spatial9.ai/mcp/free for the free guest allowance.

When to use

• "Make this song immersive / spatial / 3D."
• "Turn my stems into Eclipsa Audio."
• "Give this video a spatial soundtrack for YouTube."

Steps

1. If the user has not heard Spatial9 before, offer the free preview_chorus first (30-second headphone WAV, uses no project).
2. Get the source:

• Public https link: pass it as source_url.
• Local file: call create_upload_link with filename, PUT the file to direct_upload_url, then pass upload_id.

1. Start the render:

• Mixed song or video: create_spatial_audio with media_type (music or video), title, optional style (live_concert, club, cinema, intimate_studio) and include_binaural: true.
• 2 to 16 stems: create_from_stems with stems: [{ url | upload_id, name, instrument }]. Instruments: vocals, drums, bass, guitar, piano, keys, synth, strings, brass, other.
• Always send an idempotency_key built from the title so a retry never starts a second render.

1. Tell the user a song usually takes 10 to 20 minutes. Poll get_job_status every 30 to 60 seconds, and report stage and progress in plain words.
2. When status is completed, call get_downloads and present each file by its label. Lead with the binaural headphone WAV and the YouTube-ready MP4.

Rules

• Each render uses one project from the user's plan and is refunded automatically if it fails. Say so before the first render.
• Limits: 3 renders at once, 20 per 24 hours. Queue extra work instead of failing.
• Never invent download links. Only share URLs returned by get_downloads.
• If a tool returns isError: true, pass its message on in plain words and stop.