How do I install the Voice Compose skill?

Run npx skillmds@latest add utopai-research/voice-compose in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Voice Compose safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Voice Compose?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Voice Compose free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Voice Compose?

Utopai-Research (@utopai-research) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Voice Compose by utopai-research — Agent Skill

Name: Voice Compose
Author: Utopai-Research

Voice Compose

Designs and attaches voice samples or final narration/line audio on the filmmaking canvas via the local generate_voice.js CLI. Use before calling generate_voice.js; when the user asks to give a character a voice, preview how a character sounds, create reusable timbre anchors for every speaking character or VO/narration, or create exact narration/VO/final line audio.

File contents

Default to one short reusable timbre sample per speaking character and one VO/narrator sample when narration exists. video-compose keeps actual shot dialogue/VO in the video prompt. Treat audio_result.data.text as downstream speech only for approved final narration/line reads.

Patterns

Follow PROJECT_AGENT.md for context/staging. This skill owns voice prompt + CLI shape.

1. Character voice sample

Triggers: "give / design a voice for [character]", "what does [character] sound like", "voices for all the characters on the canvas".

Target: any image_result for the person; don't gate on subtype. Read data.local_path before prompt; layer name/role/description on top.

Call:

node "$PAI_REPO_ROOT/server/cli/generate_voice.js" \
  --text "<line>" \
  --prompt "<voice design brief>" \
  --source-node-id <character.id>

Prompt describes the voice, not the character:

[age bracket] [gender], [timbre], [register], [pace], [accent if relevant]. [optional emotional color].

✅ "Mid-50s man, gravelly baritone, measured pace, slight rasp from decades of smoking, weary but steady." ✅ "Young woman, bright mezzo, warm, quick and percussive. Slight Southern lilt." ❌ "Detective Morris's voice." — names the character, not the voice. The model needs sound qualities.
text: 1-3 sentence in-character sample (≤200 chars), not every script line.
Script breakdowns: one staged call per speaker; preserve labels. Add separate VO/narrator via Pattern 2.

2. Narrator / VO voice sample or final line audio

Triggers: narrator voice, voice-over, "a voice that says X" without character, narration track, or explicit final line-read audio.

Omit --source-node-id:

node "$PAI_REPO_ROOT/server/cli/generate_voice.js" \
  --text "<the narration line>" \
  --prompt "<voice design brief>"

Same prompt convention as Pattern 1.
Reusable VO/narrator anchor: short sample line in narrator style, not full script narration.
Final narration/line-read: copy approved text exactly into --text; then data.text is source of truth.

---name: voice-composedescription: Designs and attaches voice samples or final narration/line audio on the filmmaking canvas via the local generate_voice.js CLI. Use before calling generate_voice.js; when the user asks to give a character a voice, preview how a character sounds, create reusable timbre anchors for every speaking character or VO/narration, or create exact narration/VO/final line audio.---Default to one short reusable timbre sample per speaking character and one VO/narrator sample when narration exists. `video-compose` keeps actual shot dialogue/VO in the video prompt. Treat `audio_result.data.text` as downstream speech only for approved final narration/line reads.## PatternsFollow `PROJECT_AGENT.md` for context/staging. This skill owns voice prompt + CLI shape.### 1. Character voice sampleTriggers: "give / design a voice for [character]", "what does [character] sound like", "voices for all the characters on the canvas".- Target: any `image_result` for the person; don't gate on subtype. Read `data.local_path` before prompt; layer `name`/`role`/`description` on top.- Call: ``` node "$PAI_REPO_ROOT/server/cli/generate_voice.js" \ --text "<line>" \ --prompt "<voice design brief>" \ --source-node-id <character.id> ```- Prompt describes the **voice**, not the character: > `[age bracket] [gender], [timbre], [register], [pace], [accent if relevant]. [optional emotional color].` ✅ "Mid-50s man, gravelly baritone, measured pace, slight rasp from decades of smoking, weary but steady." ✅ "Young woman, bright mezzo, warm, quick and percussive. Slight Southern lilt." ❌ "Detective Morris's voice." — names the character, not the voice. The model needs sound qualities.- `text`: 1-3 sentence in-character sample (≤200 chars), not every script line.- Script breakdowns: one staged call per speaker; preserve labels. Add separate VO/narrator via Pattern 2.### 2. Narrator / VO voice sample or final line audioTriggers: narrator voice, voice-over, "a voice that says X" without character, narration track, or explicit final line-read audio.- Omit `--source-node-id`: ``` node "$PAI_REPO_ROOT/server/cli/generate_voice.js" \ --text "<the narration line>" \ --prompt "<voice design brief>" ```- Same prompt convention as Pattern 1.- Reusable VO/narrator anchor: short sample line in narrator style, not full script narration.- Final narration/line-read: copy approved text exactly into `--text`; then `data.text` is source of truth.

Frequently asked questions