spoken — Claude Code prompt: what it does, how to install
This Claude Code prompt marks answer content that should stay on screen rather than be spoken aloud. It handles items such as code blocks, tables, links, and images.
MIT ★ 395 updated 2026-11-16
.claude/commands/spoken.mdWhat spoken does
The prompt creates short stand-ins for parts of an answer that should remain visible but should not be read aloud. The voice model can tell that the screen contains an item, such as a code block or a link.
The template handles code, tables, links, images, file paths, lines, hashes, and code snippets. English and Japanese have dedicated branches; other languages use a separate fallback branch. In Claude Code, place the command file at .claude/commands/spoken.md.
What it helps with
- mark a code block for the voice model without reading it aloud
- signal that a link or image remains on screen
- refer to a file path without speaking its contents
Example prompts for the agent
- Prepare this answer for speech: keep the code block on screen and tell the voice model it is there.
- Mark the link with a short spoken placeholder.
- Leave
voice/spoken.govisible, but do not read its contents aloud.
How to install spoken
Manually: put the files in place
.claude/commands/spoken.mdHow to use
Paste the text at the start of a chat or into project instructions
Questions about spoken
How do I install spoken in Claude Code?
Place the command file at .claude/commands/spoken.md.
What does spoken do?
It replaces answer content that should not be spoken with short labels. The voice model is told that the content is visible on screen.
Which content types does spoken handle?
The template distinguishes code blocks, tables, links, images, file paths and lines, hashes, and code snippets.
Source text
spoken.md · MIT
{{- /* Stand-ins for what an answer holds that is not to be read out (voice/spoken.go): the voice model hears that it is
there and that the screen has it. */ -}}
{{- if eq .Lang "en" -}}
{{- if eq .Kind "code"}}(a code block of {{.N}} {{if eq .N 1}}line{{else}}lines{{end}}, on the screen)
{{- else if eq .Kind "table"}}(a table of {{.N}} {{if eq .N 1}}row{{else}}rows{{end}}, on the screen)
{{- else if eq .Kind "link"}}(a link)
{{- else if eq .Kind "image"}}(an image)
{{- else if eq .Kind "path"}}the file {{.Name}}
{{- else if eq .Kind "line"}}line {{.N}} of {{.Name}}
{{- else if eq .Kind "hash"}}(a hash)
{{- else if eq .Kind "snippet"}}(a piece of code)
{{- else}}(… the middle is left out; the whole answer is on the screen …)
{{- end -}}
{{- else if eq .Lang "ja" -}}
{{- if eq .Kind "code"}}({{.N}} 行のコード、画面に表示)
{{- else if eq .Kind "table"}}({{.N}} 行の表、画面に表示)
{{- else if eq .Kind "link"}}(リンク)
{{- else if eq .Kind "image"}}(画像)
{{- else if eq .Kind "path"}}ファイル {{.Name}}
{{- else if eq .Kind "line"}}{{.Name}} の {{.N}} 行目
{{- else if eq .Kind "hash"}}(ハッシュ)
{{- else if eq .Kind "snippet"}}(コード)
{{- else}}(……中略、全文は画面に……)
{{- end -}}
{{- else -}}
{{- if eq .Kind "code"}}(一段 {{.N}} 行的代码,在屏幕上)
{{- else if eq .Kind "table"}}(一张 {{.N}} 行的表,在屏幕上)
{{- else if eq .Kind "link"}}(一个链接)
{{- else if eq .Kind "image"}}(一张图)
{{- else if eq .Kind "path"}}文件 {{.Name}}
{{- else if eq .Kind "line"}}文件 {{.Name}} 第 {{.N}} 行
{{- else if eq .Kind "hash"}}(一串哈希)
{{- else if eq .Kind "snippet"}}(一段代码)
{{- else}}(……中间省略,全文在屏幕上……)
{{- end -}}
{{- end -}}
© nwverse · MIT · nwverse/persona