What is setup-claudio?

A setup guide for adding spoken announcements to Claude Code through text-to-speech, or TTS, which reads written output aloud.

Use it to install the voice hooks, choose an output style, set a name, and configure the related Claude Code settings.

It helps users hear about completed tasks, permission requests, and questions without relying only on the terminal screen.

setup-claudio — Skill for Claude Code by kat3samsin

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add kat3samsin/claude-code-plugins --skill setup-claudio

Clone the repo

git clone --depth 1 https://github.com/kat3samsin/claude-code-plugins

Made for: Claude Code.

Or install claudio, the plugin that ships this one along with the rest of its 1 skill, 1 command.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/kat3samsin/claude-code-plugins/setup-claudio/github.svg)](https://agentmods.dev/skills/kat3samsin/claude-code-plugins/setup-claudio)

Your own site

<a href="https://agentmods.dev/skills/kat3samsin/claude-code-plugins/setup-claudio"><img src="https://agentmods.dev/badge/skills/kat3samsin/claude-code-plugins/setup-claudio/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/kat3samsin/claude-code-plugins/setup-claudio"><img src="https://agentmods.dev/badge/skills/kat3samsin/claude-code-plugins/setup-claudio.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 18 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 488 The whole file, excluding the scripts and references it only reads on demand.

Security scan B 1 finding. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00018	$0.00488
Opus 5.5	$0.00007	$0.00195
Sonnet 5.5	$0.00004	$0.00098
Haiku 4.5	$0.00002	$0.00049

Measured 2mo ago against content hash 1d96545a8389, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade B, and why

setup-claudio scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

The scan reads SKILL.md. This mod also ships 1 executable file (setup-claudio.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

5. Updates your `~/.claude/settings.json`

plugins/claudio/skills/setup-claudio/SKILL.md · 69 lines

What it actually says

Claudio: Talk to Claude Code

This skill sets up an enhanced Claude Code experience with voice output:

Audio announcements for task completions, permission requests, and questions
Smart permission announcements that tell you exactly what's being requested
Four output styles: Full, Concise, Direct, and Conversational
Personalized with your name

How to Run

Users can trigger this skill by:

Slash command: /setup-claudio
Ask Claude: "Set up Claudio" or "Make Claude talk"

What It Does

Asks for your name
Lets you choose your preferred style:
- Full: Detailed responses with comprehensive audio summaries
- Concise: Brief, efficient responses with short audio
- Direct: No fluff, no praise, just facts (recommended)
- Conversational: Natural, friendly dialogue with warm audio
Installs output styles to ~/.claude/output-styles/
Installs TTS hooks for:
- PermissionRequest: Announces what specific permission is needed
- Notification: Announces when Claude has a question
- Stop: Announces when task is complete
Updates your ~/.claude/settings.json
Confirms setup with audio feedback

After Setup

Switch styles anytime by editing ~/.claude/settings.json:

{
  "outputStyle": "TTS Conversational"
}

Options: "TTS Full", "TTS Concise", "TTS Direct", "TTS Conversational"

Requirements

macOS (uses say command for TTS)
jq for settings configuration (brew install jq)
Optional: Premium voices (System Settings > Accessibility > Spoken Content > System Voice > Manage Voices)

Voice Customization

List available voices:

say -v '?'

Recommended voices:

Zoe (Premium) - Australian female (default)
Samantha - American female
Daniel - British male

Premium voices sound more natural but must be downloaded separately.

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

setup-claudio.sh 9.5 KB runs code

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2mo ago First seen · 69 lines · 18 tokens per session scan B 1d96545a8389

Subscribe to this mod's changes

setup-claudio is a skill published in the GitHub repository kat3samsin/claude-code-plugins (2 stars, last pushed 8mo ago), licensed MIT. It adds 18 tokens to every session and 488 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Creative and media

setup-claudio next to 6 skills from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
setup-claudiokat3samsin/claude-code-plugins	Skill	2	8mo ago	MIT	B	18	Claude Code
imagegenopenai/codex	Skill	134k	today	Apache-2.0	A	113	Codex
local-ai-agentsmicrosoft/ai-agents-for-beginners	Skill	79k	today	MIT	A	200	Claude Code, Codex
playwright-climicrosoft/playwright	Skill	99k	today	Apache-2.0	A	19	Claude Code
systematic-debuggingobra/superpowers	Skill	314k	4d ago	MIT	A	21	Claude Code
next-cache-components-adoptionvercel/next.js	Skill	143k	today	MIT	A	95	Claude Code
chat-pet-sprite-creationmicrosoft/vscode	Skill	195k	today	MIT	A	53	Claude Code, Codex

setup-claudio