Holiday offer: Vois Studio Pro for $15 a month and a free copy of The Ghost Audio MethodSee Pro
Vois
AI Agent Skills

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.

Available Skills

Two skills, one controlled workflow

Vois CLI

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
See the skill fileDownload the full skillvois.so/skills/vois-cli/SKILL.md
TTS Dialogue Writing

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
See the skill filevois.so/skills/tts-dialogue-writing/SKILL.md
Agents

For 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.

Safety limits

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.
Fast start

Try it in 30 seconds

1

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.

2

Give your agent the discovery index

https://vois.so/.well-known/agent-skills/index.json
3

Tell 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.