Skip to main content
skill CX Codex

sumi-voicebox — Claude Code skill: what it does, how to install

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.

MIT ★ 110 updated 2026-11-07

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

What sumi-voicebox does

The skill configures offline speech generation using the upstream jamiepine/voicebox project without hosted character fees. It reads system capacity and loopback status through python3 scripts/probe.py without triggering background downloads.

Model downloads and runtime components require explicit scope, showing exact source targets, disk footprint, and install paths. Synthesis operations query the local /openapi.json endpoint, tracking job IDs to avoid duplicate tasks. The skill keeps recordings private and prohibits exposing the backend to the public internet.

What it helps with

  • check local hardware capacity with python3 scripts/probe.py
  • configure on-device Voicebox narration without character billing
  • verify model downloads with exact size estimates and targets
  • track local generation jobs using the /openapi.json endpoint

Example prompts for the agent

  • Set up local Voicebox narration for my story video project
  • Run probe.py to verify hardware status before downloading models
  • Generate voice narration from approved text using local openapi.json

How to install sumi-voicebox

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

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

Questions about sumi-voicebox

How to install sumi-voicebox in Claude Code?

Run npx skills add beyondtahir/beyondsumi --skill sumi-voicebox -a claude-code.

What does sumi-voicebox do?

It guides local Voicebox narration setup, monitors hardware limits via probe scripts, and tracks generation jobs through the local API.

What is required to run sumi-voicebox?

The setup relies on python3, a local Voicebox release, and access to the local /openapi.json interface.

Source text

SKILL.md · MIT
---
name: sumi-voicebox
description: Guide optional local Voicebox narration setup, hardware/model-size checks, consented voice profiles and export for Sumi or other story videos; downloads and generation require the user's selected scope.
---

# Voicebox narration setup

Use [the verified setup guide](references/setup.md) when the user selects free local narration. Explain app versus selected speech model, hardware/storage and no per-character hosted API bill. Run `python3 scripts/probe.py` for read-only loopback status; no install/download/generation is triggered. Use the exact upstream [Voicebox repository](https://github.com/jamiepine/voicebox), official releases and current model/license information. Do not vendor models or clone the full repository just to install a desktop release.

Reuse a compatible existing app/model. Ask before missing third-party app/runtime/model downloads, with exact selected items, source, size estimate and location. Do not install every engine. Offer a licensed preset, user's own/consented reference, supplied narration or no narration. A distinctive voice can aid identity but does not guarantee platform monetization.

Check the installed local `/openapi.json` and model status before API mutations. Generate approved text once with the verified model/profile and retain job ID/take; inspect an uncertain existing job before retrying. Use the normal Generate/Export interface if this version's API differs. Never expose the backend publicly or silently use cloud services. Save non-secret preferences only; recordings and models remain private.

© beyondtahir · MIT · beyondtahir/beyondsumi

Similar skills

All skills for AI and ML →

From the same set11

The whole set →
beyondsumi beyondsumi is a Claude Code plugin that guides frame-by-frame animation from script to sound. Start with an idea, a story, or a recording. CX Codex ★ 110repo stars sumi-elevenlabs sumi-elevenlabs is a Claude Code skill that connects ElevenLabs and helps select narration voices and models for story videos. It estimates character-based charges before paid generation and waits for approval. 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-sound 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. 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

Project sponsors

Companies that keep this analytics open