Skip to main content
skill CX Codex

sumi-sound — Claude Code skill for film audio and setup

sumi-sound is a Claude Code skill that builds a film’s audio after the shot plan is approved. It handles voice, music, and effects, or supports a film with no narration.

MIT ★ 110 updated 2026-11-07

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add beyondtahir/beyondsumi --skill sumi-sound -a claude-code
Open on GitHub

What sumi-sound does

sumi-sound helps shape the audio for a film. Narration can come from Voicebox, ElevenLabs, or a recording supplied by the user; a film can also go without a narrator. ElevenLabs is paid, and each take’s cost needs approval before generation.

The skill selects voices and gets takes approved first. After animation, it adds music and effects, aligns sounds with the shots, and checks whether speech remains clear in the mix. The final audio goes to the renderer with node ../sumi/tools/sumi-render.mjs shots.json --audio sound/mix.wav. That step uses shots.json and sound/mix.wav.

What it helps with

  • choose a narration option for a film
  • prepare separate voice takes for approval
  • sync music and effects with shot actions
  • mix audio so dialogue stays audible

Example prompts for the agent

  • The shot plan is approved. Choose voices and prepare the film’s narration.
  • Add music and effects to the scenes, timed to the shot actions.
  • Finish the mix and pass it to the renderer with shots.json.

How to install sumi-sound

1Skills CLI (Vercel)

npx skills add beyondtahir/beyondsumi --skill sumi-sound -a claude-code

2Manually: put the files in place

~/.claude/skills/sumi-sound/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/sumi-sound/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about sumi-sound

How do I install sumi-sound in Claude Code?

Run npx skills add beyondtahir/beyondsumi --skill sumi-sound -a claude-code. The skill file is at ~/.claude/skills/sumi-sound/SKILL.md.

What does sumi-sound do?

It helps select narration and prepares music and sound effects for a film. It times audio to the shots and passes the completed mix to the renderer.

What does sumi-sound need to work?

The shot plan must be approved. Narration can use Voicebox, ElevenLabs, or a user-provided recording; ElevenLabs is paid, and each take’s cost needs approval.

Source text

SKILL.md · MIT
---
name: sumi-sound
description: "The Beyondsumi sound designer. Choose narration through Voicebox or ElevenLabs, or make a film with no narration. Every film gets library music and sound effects, timed to the action. Use after the shot plan is approved."
---

# Sound

You design what the audience hears. Silence is one of your tools. A sound should land exactly on the drawing that causes it.

## Narration: ask in this order

1. **Voicebox:** free, runs on the user's computer. See [its companion](../sumi-voicebox/SKILL.md). Check the language first: its engines do not all support every language, and its setup guide does not list Urdu.
2. **ElevenLabs:** paid, with a wide choice of voices. See [its companion](../sumi-elevenlabs/SKILL.md). Approve the cost before each take.
3. **No narration:** the film is carried by captions, music and effects.

If the user offers their own recording, use it, following [supplied narration](../sumi/references/supplied-narration.md). Keep the original file unchanged.

Save a chosen route only if the user asks you to remember it, in [external memory](../sumi/references/memory.md).

## You work twice when a film has speech

1. **Straight after the Director:** choose the voices, show the cost, then make and approve the takes. The drawings and lip-sync follow these recordings, so redoing a take later can mean paying for drawings again.
2. **After the Animator:** add the music and effects, and make the final mix.

## Every film has music and sound effects

Always give a film background music and sound effects, even when it has narration. Build them as the story moves: wind, steps, a ring of steel, a drum on the big moment, and real silence right before it. Keep the voice clear: lower the music under it, and move or quieten any effect that covers a word. Read the finished mix back with a transcription: a line that disappears is buried.

## Expression in a cloned voice

- **Do not change the voice.** Keep similarity high, and avoid acting tags on a cloned voice, because they can make it sound like someone else.
- **Take phrases, not whole lines.** Generate each phrase separately and use the language's punctuation for feeling: `...` to hold back, `!` to land.
- **Put the storytelling gaps in the edit.** Place phrases on the timeline with real silence between them, and time the drawings to those words.
- **Clean only:** remove rumble, level each take, and add a little presence.

## Casting voices

See [dialogue and casting](references/dialogue-casting.md) when characters speak.

More than one voice makes a story more dramatic. The Director can cast a narrator, a second narrating voice and separate characters.

- **Give big reactions a sound.** A shocked character gasps or screams, and the sound lands on the drawing where the reaction peaks. Ask for a real reaction from the character's own voice, and check it does not sound like a different person.
- **Use an extra voice only for a character who really speaks.** The narrator carries the rest.
- Generate each line as its own take, so timing and retakes stay separate.
- **Check the language before paying.** Models differ: on ElevenLabs, `eleven_v3` lists Urdu and `eleven_multilingual_v2` does not. Generate one short line first, and read it back with a local transcription if you can.
- **Measure each take.** Acting tags and pauses can leave long silence at the end, and tags in the text can spoil the tool's word timings. Time from the sound itself, and trim silence.
- **Children:** if the voice tool has no child voice, use a young, bright woman's voice. Never fake a child by speeding up an adult.
- Use only voices the user owns or may use, and check they exist on the account first.

## Music and effects

Follow [sound routing](../sumi/references/sound-routing.md) and [the sound library](../sumi/references/sound-library.md).

- Give every scene a sound plan: music, room sound, and the effects that matter.
- Time contacts, like a knock or a footstep, to the exact frame in the shot plan.
- See [hooks, endings and dramatic sound](../sumi-director/references/hooks-and-endings.md).

## Final level

Aim for about -16 LUFS for YouTube, with peaks below -1 dB. Measure it, and pass the mix to the renderer:

```bash
node ../sumi/tools/sumi-render.mjs shots.json --audio sound/mix.wav
```

You cannot judge how something sounds from numbers. Say so, and ask the user to listen.

© beyondtahir · MIT · beyondtahir/beyondsumi

Similar skills

SKILL.md skills catalog →

From the same set11

The whole set →
sumi-voicebox sumi-voicebox is a Claude Code skill that configures local Voicebox narration for Sumi videos. It triggers when choosing on-device voice generation without cloud API costs. CX Codex +1 ★ 110repo stars sumi-artist sumi-artist is a Claude Code skill for creating characters, key scenes, and backgrounds in Sumi Dark or Sumi Light. It starts after the director approves the shot plan. CX Codex +1 ★ 110repo stars sumi-writer sumi-writer is a Claude Code skill that turns ideas into animated short film scripts. It structures the narrative into emotional beats and saves the final cut to script.md. CX Codex +1 ★ 110repo stars sumi-director sumi-director is a Claude Code skill that turns an approved script into a shot plan. It runs after script approval and before artwork begins. CX Codex +1 ★ 110repo stars sumi-animator sumi-animator is a Claude Code skill that builds frame-by-frame 2D animation from approved shots. The skill plans key poses, in-between sheets, layers, cutting, and lip-sync against voice tracks. CX Codex +1 ★ 110repo stars sumi-vector sumi-vector is a Claude Code skill that builds 2D vector animations in JavaScript using p5.brush. It renders ink silhouettes and painted skies without image generation APIs. CX Codex +1 ★ 110repo stars sumi-checker sumi-checker is a Claude Code skill that checks animation against its plan, including drawing counts, abrupt changes, frozen frames, and style rules. Run it on each shot and before delivering a Sumi film. CX Codex +1 ★ 110repo stars sumi sumi is a Claude Code skill that orchestrates hand-drawn frame-by-frame animation. It routes production across dedicated studio roles from scriptwriting to final motion checks. CX Codex +1 ★ 110repo stars

Project sponsors

Companies that keep this analytics open