Agent skill

Voxtype Install

by pchalasani in pchalasani/claude-code-tools

Guide the user through installing, configuring, and launching voxtype — local on-device voice dictation (speech-to-text that types wherever the cursor is).

MITAuto-check: notesMedia & Creative

Install Voxtype Install

skills CLI
$ npx skills add pchalasani/claude-code-tools --skill voxtype-install -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pchalasani/claude-code-tools voxtype-install --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pchalasani/claude-code-tools.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/voxtype/skills/voxtype-install .claude/skills/voxtype-install && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
voxtype-install
GitHub stars
2k
Token cost
~857 tokens
SKILL.md length
386 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Guide the user through installing, configuring, and launching voxtype — local on-device voice dictation (speech-to-text that types wherever the cursor is).

  • The user asks to install voxtype
  • SKILL.md covers Install, Configure, Launch and Reference
  • Calls uv, curl and sh; reaches astral.sh
  • Set up voice dictation / voice typing

What it does

Voxtype Install is an agent skill from pchalasani/claude-code-tools. Guide the user through installing, configuring, and launching voxtype — local on-device voice dictation (speech-to-text that types wherever the cursor is). Use when the user asks to install voxtype, set up voice dictation / voice typing, or asks how to dictate into their editor, terminal, or a coding agent's prompt.

Its SKILL.md is about 860 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering Transcription and Speech recognition and synthesis. It works with macOS. The repository describes itself as: Practical productivity tools for Claude Code, Codex-CLI, and similar CLI coding agents. The licence is MIT.

When your agent uses it

  • The user asks to install voxtype
  • Set up voice dictation / voice typing
  • Asks how to dictate into their editor
  • A coding agents prompt

Example prompts

  • “/voxtype-install”

What it can do on your machine

Read from SKILL.md and the folder at commit bbb555c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv
    • curl
    • sh
    • pipx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • astral.sh

    Also links to:

    • pchalasani.github.io

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Voxtype Install loads about 857 tokens when it runs. Until then it costs about 83 tokens; SKILL.md has 386 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~83
When it runs · the whole SKILL.md, loaded when a task matches
~857

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePipes a well-known installer script into a shellSKILL.md:26
    (`curl -LsSf https://astral.sh/uv/install.sh | sh`) or use

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from pchalasani/claude-code-tools at commit bbb555c, republished under its MIT licence (© pchalasani). 386 words, ~857 tokens.

Download SKILL.mdSave it as .claude/skills/voxtype-install/SKILL.md (or your agent's skills folder).
name
voxtype-install
description
Guide the user through installing, configuring, and launching voxtype — local on-device voice dictation (speech-to-text that types wherever the cursor is). Use when the user asks to install voxtype, set up voice dictation / voice typing, or asks how to dictate into their editor, terminal, or a coding agent's prompt.

voxtype Install Guide

voxtype is a standalone PyPI package for fully on-device voice dictation on macOS. It types transcribed speech into whatever app has focus. No cloud, no accounts, no audio leaving the machine.

Install

One command; it picks the best engine for the machine automatically (Apple-GPU parakeet-mlx on Apple Silicon, CPU parakeet elsewhere):

bash
uv tool install voxtype

If the user doesn't have uv, either install it first (curl -LsSf https://astral.sh/uv/install.sh | sh) or use pipx install voxtype.

Note: voxtype only works on macOS (it types via macOS accessibility APIs). Tell the user this up front if they are on Linux/Windows.

Configure

Run the interactive wizard — it asks a handful of explained questions (engine, activation mode, hotkey, ...) and writes ~/.config/voxtype/config.toml:

bash
voxtype setup

This must run in the user's own terminal (it is interactive); do not run it through an agent shell. Alternative for hand-editors: voxtype init writes a fully commented sample config instead.

Editing the config directly

All settings live in ~/.config/voxtype/config.toml — every key is optional and the file voxtype init writes is fully commented. You (the agent) can open and edit this file to help the user tune specific options; common ones:

  • engine — parakeet-mlx (Apple GPU), parakeet (CPU), or moonshine.
  • mode — toggle (hotkey), wake (wake word), or vad (always on).
  • segmentation — hold (whole take on toggle-off) or vad (per pause).
  • hotkey — toggle chord, e.g. "<ctrl>+;" (run voxtype hotkey to record one).
  • sounds — set false to silence the start/stop chimes.
  • wake_word / wake_word_aliases, submit_phrases, overlay, paste_hotkey, cancel_hotkey, copy_to_clipboard, and more.

For the full list — every key, its default, and the engine comparison — read the Configuration & CLI reference: https://pchalasani.github.io/claude-code-tools/tools/voxtype/configuration/

Show full SKILL.md (126 more words)Show less

Launch

bash
voxtype

Then: press Ctrl+; (default hotkey), speak, press Ctrl+; again — the take is transcribed and typed at the cursor. Esc cancels a recording. Saying "go", "over", or "submit" alone presses Enter.

First-run notes for the user:

  • macOS will prompt for Microphone, Accessibility, and Input Monitoring permissions for the terminal app — all three must be granted, then voxtype restarted.
  • The first launch downloads the speech model (up to ~2 GB for the default Apple-GPU engine, ~490 MB for the CPU engine); later launches skip the download and just load it onto the GPU (a few seconds, shown by a spinner).

Reference

© pchalasani, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/voxtype/skills/voxtype-install of pchalasani/claude-code-tools.

Open the folder on GitHubat commit bbb555c

Compare with similar skills

Voxtype Install next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Voxtype Install compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Voxtype Install this skillpchalasani/claude-code-tools2k—~857Automated safety check: NotesMIT
C Voicedaxaur/openpaw173—~401Automated safety check: PassMIT
Speech Recognitiondpearson2699/swift-ios-skills1.2k—~3.7kAutomated safety check: PassCustom licence
Wjs Transcribing Audiojianshuo/claude-skills131—~4.4kAutomated safety check: NotesMIT
WatchTheCraigHewitt/skills159—~1.6kAutomated safety check: NotesMIT
Whisper Transcriptionbenchflow-ai/skillsbench1.8k—~1.1kAutomated safety check: PassApache-2.0

Similar skills

  • C Voice

    daxaur/openpaw

    Convert speech to text using sag (ElevenLabs STT) and synthesize speech using say (macOS built-in TTS).

    173 GitHub stars~401 tokensUpdated 4 mo ago
    Media & CreativeAuto-check passed
  • Speech Recognition

    dpearson2699/swift-ios-skills

    Transcribe speech to text using Apple's Speech framework. An agent skill from dpearson2699/swift-ios-skills.

    1.2k GitHub stars~3.7k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • Wjs Transcribing Audio

    jianshuo/claude-skills

    A skill your agent uses when the user has audio or video and wants a timestamped transcript (SRT) in the source language.

    131 GitHub stars~4.4k tokensUpdated 1 mo ago
    Media & CreativeAuto-check: notes
  • Watch

    TheCraigHewitt/skills

    When the user wants to read, transcribe, summarize, or research a video — YouTube link, podcast clip, Loom, TikTok, X/Twitter video, local file, or any URL yt-dlp supports.

    159 GitHub stars~1.6k tokensUpdated 4 mo ago
    Media & CreativeAuto-check: notes
  • Whisper Transcription

    benchflow-ai/skillsbench

    Transcribe audio/video to text with word-level timestamps using OpenAI Whisper.

    1.8k GitHub stars~1.1k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • Deepgram

    Anil-matcha/awesome-muse-connectors

    Deepgram speech AI: transcribe audio to text and synthesize speech (TTS).

    1.3k GitHub stars~857 tokensUpdated 4 days ago
    Media & CreativeAuto-check passed

More from pchalasani/claude-code-tools

All 18 skills in this repo
  • Remove AI Patterns

    pchalasani/claude-code-tools

    Remove AI-writing patterns ("AI-isms") from text using the avoid-ai-writing catalog (conorbronsdon/avoid-ai-writing).

    2k GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed
  • Dynamic Workflow

    pchalasani/claude-code-tools

    Create, review, run, inspect, pause, resume, and cancel durable JavaScript workflows that coordinate multiple headless Codex agents.

    2k GitHub stars~5.3k tokensUpdated yesterday
    Auto-check passed
  • Agent Style

    pchalasani/claude-code-tools

    Literature-backed English technical-prose writing rules (agent-style, 21 rules).

    2k GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed
  • Msg

    pchalasani/claude-code-tools

    Inter-agent communication via the msg CLI. An agent skill from pchalasani/claude-code-tools.

    2k GitHub stars~362 tokensUpdated yesterday
    Auto-check passed
  • Tmux CLI

    pchalasani/claude-code-tools

    CLI utility to communicate with other CLI Agents or Scripts in other tmux panes; use it only when user asks you to communicate with other CLI Agents or Scripts in other tmux panes.

    2k GitHub stars~324 tokensUpdated yesterday
    Auto-check passed
  • Voice Update

    pchalasani/claude-code-tools

    This skill should be used when the agent needs to give a spoken voice update to the user, or when reminded by a Stop hook to provide audio feedback.

    2k GitHub stars~432 tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Voxtype Install

What does Voxtype Install do?

Guide the user through installing, configuring, and launching voxtype — local on-device voice dictation (speech-to-text that types wherever the cursor is). Voxtype Install is an agent skill from pchalasani/claude-code-tools. Guide the user through installing, configuring, and launching voxtype — local on-device voice dictation (speech-to-text that types wherever the cursor is).

When should I use Voxtype Install?

Voxtype Install fits situations like: the user asks to install voxtype; set up voice dictation / voice typing; asks how to dictate into their editor; A coding agents prompt.

How do I install Voxtype Install in Claude Code?

Run `npx skills add pchalasani/claude-code-tools --skill voxtype-install -a claude-code`. Or copy the skill folder (plugins/voxtype/skills/voxtype-install in pchalasani/claude-code-tools) into .claude/skills/voxtype-install in your project. Claude Code loads it when a task matches its description.

How do I install Voxtype Install in Codex?

Run `npx skills add pchalasani/claude-code-tools --skill voxtype-install -a codex`. Or copy the skill folder (plugins/voxtype/skills/voxtype-install in pchalasani/claude-code-tools) into .agents/skills/voxtype-install in your project. Codex loads it when a task matches its description.

Can I use Voxtype Install in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pchalasani/claude-code-tools --skill voxtype-install -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/voxtype-install, .gemini/skills/voxtype-install, .github/skills/voxtype-install and .opencode/skills/voxtype-install in your project.

What does Voxtype Install need to run?

Going by SKILL.md and its folder, Voxtype Install needs the command-line tools its instructions call (uv, curl, sh and pipx).

Does Voxtype Install access the network?

SKILL.md names 2 domains. In commands or code: astral.sh; the agent is likely to contact it when it follows the instructions. As links in the text: pchalasani.github.io. This is read from the text; nothing was executed.

Is Voxtype Install safe to install?

Our automated static check of SKILL.md found notes only (pipes a well-known installer script into a shell), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Voxtype Install use?

Voxtype Install is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Voxtype Install use?

About 857 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Voxtype Install?

Skills that share tags, products or a category with Voxtype Install: C Voice (daxaur/openpaw, 173 stars), Speech Recognition (dpearson2699/swift-ios-skills, 1.2k stars), Wjs Transcribing Audio (jianshuo/claude-skills, 131 stars) and Watch (TheCraigHewitt/skills, 159 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Voxtype Install?

pchalasani (a GitHub user) maintains it in pchalasani/claude-code-tools, which has 2,012 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 9, 2026.

Source: pchalasani/claude-code-tools on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.