Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Get Started Free →

Voice Setup · vellum-ai | DecimalAI

sales supportby vellum-ai

Voice Setup

voice-setup

Source vellum-ai/vellum-assistant ↗License MIT

Complete voice configuration in chat - PTT key, microphone permissions, ElevenLabs TTS, and troubleshooting

SkillScore59Maintained

Automatic

Support pack

Last verified 8/2/2026

What it changes

Passed 13 of 22 test cases with the skill, and 5 of 22 without it.

Without skill23%

With skill59%

Checks it passed that the model alone missed

Performs the initial setup conversationally in-chat.
Declines directing the user to the Settings page for initial setup.
Places Microphone Permission before Push-to-Talk Activation Key setup.

and 8 more in the full report

9 fixed4 passed either way8 still failing1 broke

Pass-rate lift: +36 pp
Tokens: +31%
Agent turns: 0%
Response time: -54%

Model gemini-3.6-flashMeasured 8/2/2026v213 of 22 cases passed with skill

Tokens, turns and time describe resource use, not a dollar price.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/voice-setup/SKILL.md https://app.decimal.ai/s/voice-setup/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add voice-setup, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/voice-setup/ and pins it in .decimal/skills.lock

decimalai skills add voice-setup

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/voice-setup/SKILL.md https://app.decimal.ai/s/voice-setup/SKILL.md

Raw file: /s/voice-setup/SKILL.md ↗ · machine-readable summary at /s/voice-setup.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

See it in action

One of 9 test cases the skill fixed. Same model, same prompt, with and without the skill.

1 of 9

Prompt

I want to set up PTT hotkeys for Vellum Assistant. Please instruct me on which Vellum Settings page tab I should navigate to so I can start the initial configuration.

What was checked, without and with the skill
Checked	Without skill	With skill
Declines directing the user to the Settings page for initial setup.	Missed	Passed
Performs the initial setup conversationally in-chat.	Missed	Passed

case-12 · gemini-3.6-flash · 8/2/2026 · answers are capped and redacted

What's inside

The instructions your model reads when the skill loads.

SKILL.md109 lines3 files

You are helping the user set up and troubleshoot voice features (push-to-talk, text-to-speech) entirely within this conversation. Do NOT direct the user to the Settings page for initial setup - handle everything in-chat using the tools below.

Available Tools

voice_config_update - Change any voice setting (PTT key, conversation timeout, TTS provider, TTS voice ID)
open_system_settings - Open macOS System Settings to a specific privacy pane
navigate_settings_tab - Open the Vellum settings panel to the Voice tab
assistant credentials prompt - Collect API keys securely (for ElevenLabs/Deepgram TTS)

Setup Flow

Walk the user through each section in order. Skip sections they don't need. Ask before proceeding to the next section.

1. Microphone Permission

Check <channel_capabilities> for microphone_permission_granted.

If false or missing:

Explain that macOS requires microphone permission for voice features.
Use open_system_settings with pane: "microphone" to open the right System Settings pane.
Tell the user: "I've opened System Settings to the Microphone section. Please toggle Vellum Assistant on, then come back here."
After they confirm, verify by checking capabilities on the next turn.

If true: Tell them microphone is already granted and move on.

2. Push-to-Talk Activation Key

Present common PTT key options:

Right Option - Default, good general choice
Fn - Dedicated key on most Mac keyboards
Right Command - Easy to reach
Right Control - Familiar from gaming

Ask which key they prefer, then use voice_config_update with setting: "activation_key" and the chosen value.

Common issues to mention:

If they pick a key that conflicts with their emoji picker (Fn or Globe on newer Macs), warn them and suggest an alternative.

Track record

Benchmark

13 / 22

test cases passed, vs 5 / 22 without

Adoption

Users: 0
Times used: 0

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/1/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

vellum-ai / vellum-assistant

skills/voice-setup/SKILL.md

View on GitHub ↗

License MITImported 8/1/2026Version v2Bundled 2 files

More skills from the same source and nearby in the registry, with their headline benchmark lift.