mlx-tts SKILL.md skillA
mlx-tts from renky1025/agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add renky1025/agent-skills/mlx-tts@git:20260925.32ce6c0Pins git:20260925.32ce6c0 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- renky1025/agent-skills
- Path
mlx-tts/SKILL.md- Versions recorded
- 2
- Latest version
- git:20260925.32ce6c0, committed Sep 25, 2026
- First version recorded
- Apr 21, 2026
- Size
- 7,074 bytes
- Repository stars
- 11
- License
- MIT
Apple Silicon Mac 本地语音合成 (TTS) 与语音识别 (ASR)，基于 MLX 框架的 Qwen3-TTS 1.7B / Qwen3-ASR，支持用文字提示词设计音色、无需参考音频，全程离线、无 API key。Use when you need to turn text into speech on an M-series Mac, design a voice with a text prompt, or transcribe audio locally. 触发词：文字转语音、文本转语音、TTS、语音合成、生成配音、旁白配音、有声书、语音转文字、ASR、speech synthesis、text to speech、local TTS、voice design on Apple Silicon、Qwen3-TTS。Do NOT use when：非 Apple Silicon（Intel Mac / Windows / Linux）、需要从参考音频做真人音色克隆、内存低于 16GB、或需要把配音对齐到视频时间轴（改用 video-dubbing）。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# mlx-tts: Apple Silicon 本地语音合成 ## Purpose 用 MLX 框架在本机跑 Qwen3-TTS，把文本合成为高质量语音，并可用文字提示词设计音色； 附带 Qwen3-ASR 做语音转文字。全程离线、无 API key。本技能是一套操作协议：装好环境、 跑对命令、验证产物——不做云端调用，也不做提示词音色的临场猜测（那部分查参考文件）。 ## When to Use - 在 Apple Silicon Mac（M1/M2/M3/M4）上需要高质量本地 TTS。 - 想用文字提示词设计音色，例如 `"a warm female voice, slightly soft"`。 - 需要本机 ASR（语音转文字）。 - 希望利用 Apple Neural Engine 获得快速推理，且数据不出本机。 - 触发词：文字转语音、TTS、语音合成、生成配音、旁白、有声书、语音转文字、ASR、 text to speech、speech synthesis、local TTS、voice design。 ## When NOT to Use - 非 Apple Silicon（Intel Mac / Windows / Linux）-> 改用其他 TTS 方案。 - 需要从参考音频做真人音色克隆 -> 本模型只支持提示词式音色设计。 - 内存低于 16GB -> 也许能跑，但更慢。 - 需要把配音逐段对齐到视频时间轴、烧录字幕 -> 交给 `video-dubbing`。 - 需要把整段视频转成结构化纪要 -> 交给 `video-minutes`。 ## Workflow 1. **安装**（一次性）： `brew install ffmpeg uv && uv tool install --force "mlx-audio" --prerelease=allow` 2. **验证安装**：`uv tool list | grep mlx` 应显示 `mlx-audio v0.4.2`。若命令找不到， 重启终端或 `uv tool update-shell`。首次生成会自动下载模型（约 2GB）。 3. **生成 TTS**： `mlx_audio.tts.generate --text "你好，这是本地 TTS 测试" --output-path ./output.wav` 需要设计音色时追加 `--instruct "a warm, gentle female voice"`。音色示例见 `references/voice-design.md`。 4. **长文本分块**：文本超过约 500 字时按句子边界切分（每块 <= 300 字），逐块生成后用 ffmpeg …
Read the whole file at its exact version.
How to install
mdr add renky1025/agent-skills/mlx-tts@sha256:db98b2ae851e8991The line at the top of this page pins the label git:20260925.32ce6c0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_6sng7aydljbsuxn6)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, between Apr 21, 2026 and Sep 25, 2026, about one every 157 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260925.32ce6c0 latest | 2026-09-25 | 32ce6c0 | 7,074 B | A | view · diff |
| git:20260421.63dcdf9 | 2026-04-21 | 63dcdf9 | 14,971 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (7074 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
renky1025/agent-skills · 11 stars · license MIT · pushed 2026-10-10 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_6sng7aydljbsuxn6 GET https://markdownregistry.com/api/v1/resolve?ref=renky1025/agent-skills/mlx-tts GET https://markdownregistry.com/api/v1/blob/db98b2ae851e8991f5265fa79bd5d56c4dc9a3715f7945195237f4423d859d52
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.