Tell AI agents how to control your voice studio
The skill files on the Vois website give Claude Code, Codex, Cursor, Gemini and other AI agents accurate instructions for the installed Vois CLI. The commands operate on your computer, and only after your approval.
About skills
A skill is a markdown file with a specified structure. It tells an AI agent how to use a specified tool. You do not write code for each agent. You give your agent the URL of the skill. The agent reads the file and shows the correct local commands. Then you give your approval.
The agent downloads the skill
Give your agent the discovery index. The agent makes sure that the digest is correct. Then it downloads the file or the full archive that the index shows.
The agent gets the commands
The skill gives the command groups, the usual flags, the output formats, the exit codes and the rules to use after an error.
The agent does the approved steps
You examine the command and the output path. Then the agent does the approved production step on your computer.
Two skills, one controlled workflow
The full skill for the local CLI. It gives the paths of the installed CLI, and the Vois team examines these paths for each new version. It also gives the account status, the credit update after a checkout, command instructions, voice IDs, output formats and error codes. Its production procedures wait for your approval.
Information that the skill gives agents
- Spoken output on your computer with vois speak, on all plans
- Audio generation from text with library voices, cloned voices, Voice Design voices or the ten Sonic voices
- Projects with many scripts and with speaker assignments
- Audio export with the mastering profile for each platform (ACX, Spotify, YouTube)
- How to clone voices, show your Voice Design voices and use pronunciation dictionaries
- Batch generation from text files, with the model that you select
- How to select the engine: Sonic, Fast, Expressive, Multilingual, Omni or Craft
A guide to write dialogue that AI voices speak almost the same as a person. It includes speed and pauses, speaker tags, Expressive reaction tags, directions in usual words for Omni and Craft, and templates for podcasts, audiobooks, YouTube and documentaries.
Information that the skill gives agents
- How to write dialogue that an AI voice speaks almost the same as a person
- Rules for each engine: a small number of reaction tags on Expressive ([laugh], [sigh]), and directions in usual words on Omni and Craft
- On Sonic, Fast and Multilingual, only the words of the script control how the voice speaks
- How to use the correct speaker tags in scripts with many speakers
- How to control the speed with punctuation, sentence length and pause nodes
- How to use the template for each type of content
- Usual TTS errors that you must prevent: very long text from one speaker, and too many tags
vois.so/skills/tts-dialogue-writing/SKILL.mdFor AI agents that operate on your computer
The agent must start the installed CLI on the same computer as the open Vois Studio app, as the same OS user.
Claude Code
Use the archive or the skill source in a local session that can start terminal commands as your OS user.
OpenAI Codex
Add the skill to a local task. Examine the commands and output paths that the agent shows before you give your approval.
Cursor
Attach the skill to a local workspace only if the agent has approval to start terminal commands.
Other local agents
They can use the skill if they can download the archive and start the installed CLI on the same computer and OS account as Vois Studio.
Chat-only agents
These agents can read the skill and prepare a plan. They cannot control Vois Studio without a local command tool. You must give approval for that tool independently.
Remote or cloud agents
When they download the skill, they do not get access to local IPC. They must have a local tool that can start commands with your approval.
The skill gives instructions. You keep control.
- Vois Studio must be open on your computer. Vois Studio makes a new IPC token each time it starts. Only the same OS user can get this token.
- Before you give approval, the agent must show each command that makes a change, and its output path.
- You buy subscriptions and export credits in the Polar checkout. An agent can tell you about the plans and credit packs. After you tell it that the checkout is complete, it can update the number of credits. The agent cannot buy for you.
Try it in 30 seconds
Install Vois and open the app
Download Vois for macOS or Windows. Keep the app open. For each new version, the Vois team examines the default CLI paths: /Applications/Vois.app/Contents/MacOS/vois-cli and %LOCALAPPDATA%\Vois\vois-cli.exe.
Give your agent the discovery index
https://vois.so/.well-known/agent-skills/index.jsonTell the agent to make a plan. Then give approval for the command.
Example:
“Read the Vois CLI skill. Write a 30-second introduction for a podcast. Show the voice ID, the command and the output path. Do not generate or export audio before I give approval.”Let your agent do the production steps
Download Vois Studio. Give the skill archive to your local agent. The agent makes sure that the archive is correct. You give approval for each production step.