Skill

cast

This skill should be used when the user asks to "change narrator voice", "set voice", "list voices", "narrator cast", "switch voice", "cast voice", or wants to change the text-to-speech voice used by narrator.

Install

npx claudepluginhub shreyas-s-rao/claude-code-narrator --plugin narrator

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Kokoro provides these voices:

SKILL.md

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

139.0k

claude-opus-4-5-migration

2 files

Migrates code, prompts, and API calls from Claude Sonnet 4.0/4.5 or Opus 4.1 to Opus 4.5, updating model strings on Anthropic, AWS, GCP, Azure platforms.

claude-opus-4-5-migration

83.2k

bmad-help

Analyzes BMad project state from catalog CSV, configs, artifacts, and query to recommend next skills or answer questions. Useful for help requests, 'what next', or starting BMad.

bmad-pro-skills

43.8k

Stats

Stars1

Forks1

Last CommitMar 20, 2026

Actions

View Source View Plugin View on GitHub View README

Change Narrator Voice

Available Voices

Kokoro provides these voices:

Female voices:

af_heart (default) - warm, expressive
af_bella - clear, professional
af_nicole - soft, gentle
af_sarah - bright, energetic
af_sky - calm, composed

Male voices:

am_adam - deep, authoritative
am_michael - warm, friendly
am_fenrir - bold, commanding

Determine Scope

Check if the user said "locally", "for this directory", "for this project", or similar. If so, changes apply to the local config file in the current working directory.

Global (default): ~/.claude-code-narrator/config
Local: <cwd>/.claude-code-narrator/config

Changing the Voice

If the user specifies a voice name, read the appropriate state file and use the Edit tool to change or add the voice= line to the requested voice.

Global mode (default):

Read ~/.claude-code-narrator/config and use the Edit tool to change the voice= line.

Local mode:

Read <cwd>/.claude-code-narrator/config. If the file exists, use the Edit tool to change or add the voice= line. If the file does not exist, create the <cwd>/.claude-code-narrator/ directory if needed, then create the config file with the Write tool containing just voice=<requested_voice>.

IMPORTANT: Do NOT use sed to edit state files — use the Read and Edit tools instead.

If the user does not specify a voice, present the list above and ask which voice they would like to use.

After changing the voice, speak a test sentence to confirm:

echo "This is how I sound with the new voice." | bash "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/speak.sh" --force

Changing Speed

If the user asks to change speed, read the appropriate state file and use the Edit tool to change or add the speed= line to the new value.

For local mode, if the file does not exist, create the <cwd>/.claude-code-narrator/ directory if needed, then create the config file with the Write tool containing just speed=<value>.

IMPORTANT: Do NOT use sed to edit state files — use the Read and Edit tools instead.

Valid speed range: 0.5 to 2.0. Default is 1.1.