Teach AI agents to control your voice studio
Hosted skill files that give Claude Code, Codex, Cursor, Gemini, and other AI agents accurate instructions for using the installed Vois CLI, with local execution and user approval kept explicit.
What are skills?
Skills are structured markdown files that teach AI agents how to use specific tools. Instead of writing custom integrations, you point your agent at a skill URL. The agent reads the file and proposes the right local commands for you to approve.
Agent fetches the skill
Give your agent the discovery index. It verifies the digest and fetches the advertised file or complete archive.
Agent learns the commands
The skill covers the command groups, common flags, output formats, exit codes, and recovery rules needed for production workflows.
Agent runs approved steps
You review the command and output path. The agent then runs the approved local production step.
Two skills, one controlled workflow
The complete local CLI skill. Covers release-tested install paths, authenticated status and credit recovery, command guidance, voice IDs, output formats, error codes, and approval-aware production workflows.
What this skill teaches agents
- Generate speech from text with library, cloned, or designed voices
- Create and manage multi-script projects with speaker assignments
- Export audio with platform mastering profiles (ACX, Spotify, YouTube)
- Clone voices, list designed voices, and manage pronunciation dictionaries
- Batch-generate from text files with explicit model selection
- Switch between 4 TTS engines with provider and precision options
A writing guide for creating natural-sounding dialogue optimized for AI voice synthesis. Covers pacing, speaker tags, supported paralinguistic tags by model, and format-specific templates for podcasts, audiobooks, YouTube, and documentaries.
What this skill teaches agents
- Write dialogue that sounds natural when read by AI voices
- Use model-supported paralinguistic tags ([laugh], [sigh], [laughter], [question-oh])
- Structure multi-speaker scripts with proper speaker tags
- Control pacing through punctuation, sentence length, and pause nodes
- Apply format-specific templates for different content types
- Avoid common TTS anti-patterns (run-on monologues, over-tagging)
vois.so/skills/tts-dialogue-writing/SKILL.mdWorks with local-capable AI agents
The agent must run the installed CLI on the same machine and as the same operating-system user as the open Vois app.
Claude Code
Use the archive or skill source from a local session that can run terminal commands as your OS user.
OpenAI Codex
Load the skill in a local task, then review and approve the commands and output paths it proposes.
Cursor
Attach the skill to a local workspace only when the agent has an approved terminal execution path.
Other local agents
Compatible when they can fetch the archive and execute the installed CLI on the same machine and OS account as Vois.
Chat-only agents
They can read the skill and prepare a plan, but cannot control Vois without a separately approved local command tool.
Remote or cloud agents
Downloading the skill does not bridge them to local IPC. They need an explicit local execution environment.
The skill teaches; you stay in control
- Vois must already be running locally. The per-launch IPC token is available only to the same OS user.
- The agent should show state-changing commands and output paths before you approve them.
- Subscriptions and export credits are purchased by you in Polar's hosted checkout. An agent may explain options and sync the balance after you confirm completion, but it cannot buy on your behalf.
Try it in 30 seconds
Install Vois and open the app
Download Vois for macOS or Windows and leave it open. The release-tested CLI paths are /Applications/Vois.app/Contents/MacOS/vois-cli and %LOCALAPPDATA%\Vois\vois-cli.exe by default.
Give your agent the discovery index
https://vois.so/.well-known/agent-skills/index.jsonAsk for a plan, then approve the command
Try something like:
"Read the Vois CLI skill. Propose a 30-second podcast intro, the exact voice ID, command, and output path. Wait for my approval before generating or exporting."Ready to automate?
Download Vois, give your local agent the verified skill archive, and approve each production step.