vox

Name: vox
Author: diegosouzapw

AI Verified v0.1.0

Repo stars 39
Author updated Live
Author repo awesome-omni-skill

Fluxly profile Facts only: domain, agents, trust score, runtime, permissions and network

Domain: AI · mcp · voice · tts
Compatible agents: Claude Code
Cursor
Cline
Codex
Windsurf
Gemini CLI

+20
Trust score: 98 / 100 · audit passed
Author / version / license: @diegosouzapw · v0.1.0 · no license declared
Token usage: Lean
Setup complexity: Guided setup
External API key: Not required
Operating systems: Unspecified (assume cross-platform)
Runtime requirements: No special requirements
Permissions: Read-only
Shell exec
Env read
Write / modify
Network behavior: Local-only
Install commands: 26 variants

Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.

Output preview vox.preview

---
name: vox
description: Lightweight voice MCP server with local Moonshine STT + Kokoro TTS Vox is a lightweight voice MC…
category: ai
runtime: no special runtime
---

# vox output preview

## PART A: Task fit
- Use case: Lightweight voice MCP server with local Moonshine STT + Kokoro TTS Vox is a lightweight voice MCP server (~1,500 lines of Rust) providing local text-to-speech (Kokoro) and speech-to-text (Moonshine Base) via the MCP protocol. It runs as a stdio subprocess per MCP client, or as a shared HTTP daemon. runs entirely locally. Works with Claude Code, Cursor, Cl….
- Inputs: target material, constraints, expected output, and acceptance criteria.
- Evidence boundary: follow “Project Overview / Build & Test / Architecture” and do not present inference as author intent.

## PART B: Execution result
- **01** The card summarizes the use case; runtime output centers on “Lightweight voice MCP server with local Moonshine STT + Kokoro TTS Vox is a lightweight voice MCP server (~1,500 lines of Rust) providing local text-to-speech (Kokoro) and speech-to-text (Moonshine Base) via the MCP protocol. It runs as a stdio subprocess per MCP client, or as a shared HTTP daemon. runs entirely locally. Works with Claude Code, Cursor, Cl…”.
- **02** When the source has headings, the agent prioritizes “Project Overview / Build & Test / Architecture” so the result follows the author’s structure.
- **03** Typical output includes task judgment, concrete steps, required commands or file edits, validation, and follow-up options.
- **04** Risk context follows the fingerprint: read files, run shell commands, read environment variables, write/modify files; mostly runs locally; usually needs no extra API key.

## Running Rules
- read files, run shell commands, read environment variables, write/modify files; mostly runs locally; usually needs no extra API key.
- Validate with a small sample before expanding scope.
- Return the result, validation criteria, and next iteration options.

SKILL.md SKILL.md

---
name: vox
description: Lightweight voice MCP server with local Moonshine STT + Kokoro TTS Vox is a lightweight voice MC…
category: ai
source: diegosouzapw/awesome-omni-skill
---

# vox

## When to use
- Lightweight voice MCP server with local Moonshine STT + Kokoro TTS Vox is a lightweight voice MCP server (~1,500 lines…
- Use it when the task has clear inputs, repeatable steps, and validation criteria.

## What to provide
- Target material, scope, expected result, and forbidden changes.
- Whether network, commands, file writes, or external services are allowed.

## Execution rules
- Organize steps around “Project Overview / Build & Test / Architecture” and keep inference separate from source facts.
- read files, run shell commands, read environment variables, write/modify files; mostly runs locally; usually needs no extra API key.
- Validate with a small sample before expanding the task.

## Output requirements
- Return the deliverable, key evidence, validation method, and next action.
- Mark missing information as unknown; do not invent commands, platforms, or dependencies.

Evidence boundary and execution chain

The author source anchors workflow facts; repository files anchor sources and commands; Fluxly only adds fit, limitations, and quality judgment.

skill "vox" {
  input      -> user goal + target files + boundaries + acceptance criteria
  context    -> Project Overview / Build & Test / Architecture
  rules      -> SKILL.md triggers / order / output contract
  runtime    -> no special runtime | read files, run shell commands, read environment variables, write/modify files | mostly runs locally
  guardrails -> usually needs no extra API key + small-sample validation + diff/log review
  output     -> copyable result + checklist + next iteration
}

Interpretation is structured for decision-making; original keeps the upstream SKILL.md unchanged.

Decide Fit First

Core job: Lightweight voice MCP server with local Moonshine STT + Kokoro TTS Vox is a lightweight voice MCP server (~1,500 lines of Rust)…
Best fit: Use it when the task has reusable inputs, steps, and validation criteria rather than a one-off answer.
Avoid forcing it: If the source lacks commands, platform support, or external-service evidence, keep those fields unknown instead of guessing.

Design Intent

Structure: The skill is organized around “Project Overview”, “Build & Test”, “Architecture”, “Transport Modes”, showing how the author expects the agent to judge fit, collect context, and produce verifiable output.
Trigger evidence: Prioritize the author’s wording around when to use it, what context to collect, and what output shape to produce.
Evidence boundary: Author text states facts, repository files prove commands and paths, and Fluxly only adds fit, limits, and usage judgment.

How To Use It

Inputs: Provide target material, scope, expected result, forbidden changes, and validation method.
Invocation: Name vox directly; if the source includes slash commands, start with the command and then add task context.
Validation: Start small and check whether the result follows “Project Overview / Build & Test / Architecture” before expanding.

Boundaries And Review

Dependencies: It usually needs no extra API key, so start with a small validation task.
Permissions: Declared permissions include read / shell-exec / env-read / write; ask the agent to state file, command, and rollback boundaries before acting.
Quality bar: A useful result names the deliverable, evidence, and next action. Generic prose means the task needs tighter context.

Vox — Claude Code Skill

Project Overview

Vox is a lightweight voice MCP server (~1,500 lines of Rust) providing local text-to-speech (Kokoro) and speech-to-text (Moonshine Base) via the MCP protocol. It runs as a stdio subprocess per MCP client, or as a shared HTTP daemon.

Build & Test

cargo check                    # type-check only
cargo test                     # run all unit tests (84 tests across 10 modules)
cargo clippy -- -D warnings    # lint — must pass with zero warnings
cargo build --release          # optimized build (LTO + single codegen unit)
cargo bench -- resample        # benchmark resampling

All of cargo test, cargo clippy -- -D warnings, and cargo fmt --check must pass before submitting changes.

Architecture

Module	Purpose
`main.rs`	Entry point, config loading, model download, stdio/daemon startup
`cli.rs`	Clap CLI parser: daemon, config, download-models subcommands
`server.rs`	MCP tool handlers (`say`, `listen`, `converse`), streaming TTS pipeline
`tts.rs`	Kokoro TTS engine wrapper, voice name → speaker ID resolution, sentence splitting
`audio.rs`	cpal-based mic capture and speaker playback, Lanczos-3 sinc resampling
`stt.rs`	Moonshine Base STT engine wrapper
`vad.rs`	Voice activity detection (Silero ONNX)
`config.rs`	TOML config loading, env var overrides (`VOX_*` prefix), path resolution
`daemon.rs`	HTTP daemon lifecycle: daemonize, PID file, start/stop/status/log
`models.rs`	Model readiness checks and download/extraction
`lib.rs`	Public re-exports for benchmarks (`audio`, `config`, `error`, `tts`)
`error.rs`	`VoiceError` enum with `thiserror` derives

Transport Modes

Stdio (default): rmcp::transport::stdio(). One process per MCP client.
Daemon (vox daemon start [--port PORT]): StreamableHttpService via rmcp. Single process, models loaded once, multiple clients connect over HTTP/SSE. Factory closure creates a VoiceMcpServer per session with shared Arc<Mutex<TtsEngine>> and Arc<Mutex<SttEngine>>.

Config System

Precedence (highest wins):

Environment variables: VOX_SPEED, VOX_VOICE, VOX_MODEL_DIR, VOX_LOG_LEVEL, VOX_PORT
TOML file: $XDG_CONFIG_HOME/vox/config.toml
Compiled defaults (Config::default())

CLI management: vox config get [key], vox config set <key> <value>, vox config path

MCP Tools

Tool	Description
`say`	Speak text aloud through speakers (TTS only)
`listen`	Record from microphone and transcribe (STT only)
`converse`	Speak text then listen for response (TTS + STT round-trip)

Available Voices

American female (af_*): heart, alloy, aoede, bella, jessica, kore, nicole, nova, river, sarah, sky American male (am_*): adam, echo, eric, liam, michael, onyx, puck, santa British female (bf_*): alice, emma, lily British male (bm_*): daniel, fable, george, lewis

Default: af_heart (ID 0). Voices can be specified by name or numeric ID.

Code Conventions

Edition 2024 — uses let chains (if let Ok(x) = ... && let Ok(y) = ...)
Visibility: pub(crate) for test-only exposure, not fully pub
Clippy: treat all warnings as errors (-D warnings)
Tests: inline #[cfg(test)] mod tests per module, tempfile for filesystem tests
unsafe impl Send: TtsEngine and CaptureHandle have manual Send impls due to non-Send cpal/sherpa internals confined to dedicated threads

Dev Workflow

Make changes
cargo test — verify all 84 tests pass
cargo clippy -- -D warnings — zero warnings
cargo fmt --check — formatting
If touching audio.rs resampling: cargo bench -- resample

Install command

One-click installPick a runner, click Copy, paste into your terminal, press enter

npx skills add diegosouzapw/awesome-omni-skill/skills/tools/vox -y

Open general install guide

View skill source

Works with

Claude Code
Cursor
Cline
Codex
Windsurf
Gemini
OpenCode
Roo Code
AAide
+Augment
GitHub Copilot
OpenClaw
KKiro
Junie
WWarp
Goose
Trae
Kilo Code
OpenHands
Amp
Zencoder
CContinue
AIAider
CodeBuddy
CodeGeeX
Replit Agent

Security audit

98 / 100

Verified

未声明 license/许可。

Metadata

Source: github
diegosouzapw/awesome-omni-skill
Version: 0.1.0
中文

More by @diegosouzapw

Category & tags

Category AI