off

This skill should be used when the user asks to "disable narrator", "turn off voice", "stop narrator", "disable voice output", "narrator off", "mute narrator", or wants to deactivate text-to-speech ou

SKILL.md

GitHub

Disable Narrator Voice Output

To disable narrator voice output:

Step 1: 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

Step 2: Update State File

Global mode (default):

Read ~/.claude-code-narrator/config. If the file exists, use the Edit tool to change the enabled= line to enabled=false. If the file does not exist, create it with the Write tool containing just enabled=false.

Local mode:

Read <cwd>/.claude-code-narrator/config. If the file exists and has an enabled= line, use the Edit tool to change it to enabled=false. If the file exists but has no enabled= line, use the Edit tool to add enabled=false. 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 enabled=false.

To remove the local override entirely (reverting to global state), delete the <cwd>/.claude-code-narrator/ directory instead.

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

Step 3: Remove Auto-Hush Hook (global mode only)

Only for global mode: Read ~/.claude/settings.json. If it has a UserPromptSubmit hook that runs hush-on-input.sh, remove that entire UserPromptSubmit entry from the hooks object. Preserve all other hooks.

For local mode, do NOT remove the auto-hush hook (other sessions may still need it).

IMPORTANT: Do NOT remove other hooks — only remove the narrator UserPromptSubmit hook. Read the file first.

Step 4: Confirm

For global mode, inform the user: "Narrator is now disabled. Voice output is off."

For local mode, inform the user: "Narrator is now disabled for this directory. Global setting is unchanged."

Do NOT attempt to speak this confirmation (narrator is now off).