audio-rename
Rename audio files with Chinese/special characters to simple English names for mlx-stt compatibility.
Best use case
audio-rename is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Rename audio files with Chinese/special characters to simple English names for mlx-stt compatibility.
Teams using audio-rename should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/audio-rename/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How audio-rename Compares
| Feature / Agent | audio-rename | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Rename audio files with Chinese/special characters to simple English names for mlx-stt compatibility.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
AI Agents for Marketing
Discover AI agents for marketing workflows, from SEO and content production to campaign research, outreach, and analytics.
AI Agents for Startups
Explore AI agent skills for startup validation, product research, growth experiments, documentation, and fast execution with small teams.
SKILL.md Source
# Audio Rename Skill
将带有中文/特殊字符的音频文件重命名为纯英文名称，避免 mlx-stt 等工具处理时出现路径问题。
## Usage
**推荐使用 Python 版本（更好地处理 Unicode 文件名）：**
```bash
# 重命名单个文件为默认名称 video_audio.m4a
python3 ${baseDir}/audio-rename.py <文件路径>
# 重命名为指定名称
python3 ${baseDir}/audio-rename.py <文件路径> <新名称>
# 批量重命名目录下所有音频文件
python3 ${baseDir}/audio-rename.py <目录路径> --all
```
## Examples
```bash
# 重命名为 video_audio.m4a
python3 skills/audio-rename/audio-rename.py "/path/to/中文文件.m4a"
# 重命名为指定名称
python3 skills/audio-rename/audio-rename.py "/path/to/文件.m4a" "my_audio"
# 批量重命名
python3 skills/audio-rename/audio-rename.py "/path/to/audio/" --all
```
## Workflow (推荐)
配合 bili + mlx-stt 使用：
```bash
# 1. 下载音频
bili audio BV1xxx --no-split -o /Users/linyi/.openclaw/workspace/audio/
# 2. 重命名（如有中文）
python3 skills/audio-rename/audio-rename.py /Users/linyi/.openclaw/workspace/audio/*.m4a
# 3. 转录
bash skills/mlx-stt/mlx-stt.sh /Users/linyi/.openclaw/workspace/audio/video_audio.m4a
```
## Default Naming
- 单个文件：`video_audio.m4a`（如已存在则自动添加序号）
- 批量处理：`audio_001.m4a`, `audio_002.m4a`, ...Related Skills
youtube-audio-download
Download YouTube video audio and convert to MP3. Supports age-restricted videos with cookies.
audio-play
Play audio files using Windows media player. Non-blocking execution.
audiobooklm
提供有声书创作与音频能力（ABS 读写、音效/音频检索、二创、音色推荐、章节角色分析等），通过 HTTP Streamable MCP 调用。
qwen-audio-lab
Hybrid text-to-speech, reusable voice cloning, and narrated audio generation for macOS plus Aliyun Qwen. Use when the user wants to convert text into speech, clone and reuse a voice from a reference recording, generate narration files from plain text or text files, or create PPT speaker-note voiceovers.
deapi-audio
Text-to-speech, voice cloning, voice design, and transcribe audio files via deAPI GPU network. Trigger on 'text to speech', 'TTS', 'generate voice', 'read aloud', 'voice clone', 'clone voice', 'voice design', 'design voice', 'custom voice', 'transcribe audio', 'STT'. For video/YouTube transcription use deapi-video instead.
audio-summary Skill
音频/视频转文本总结助手。
Audio Transcription Skill
Auto-transcribe voice messages using faster-whisper (local, no API key needed).
audio-script-writer
Convert written medical content into podcast or video scripts optimized for audio delivery. Transforms academic papers, reports, and educational materials into engaging spoken-word formats with pronunciation guides, timing markers, and audio-friendly structure.
audio-to-text-and-video-to-text
Transcribe audio and video files into text using OpenAI's Whisper API. Use this skill whenever a user wants to convert any audio or video file to text — including MP3, MP4, WAV, M4A, OGG, WEBM, MOV, AVI, FLAC, and more. Trigger this skill for any request involving: "transcribe", "convert audio to text", "speech to text", "get transcript of", "extract audio from video", "meeting notes from recording", "subtitles", "captions", or similar. Also trigger when the user uploads or references a media file and asks what was said, discussed, or mentioned in it. If unsure whether audio/video transcription is involved, use this skill.
u2-audio-file-transcriber
Transcribe audio files via UniCloud ASR (云知声语音识别, recorded audio → text) API from UniSound. Supports multiple formats, optimized for finance, customer service, and other domains.
name: u2-audio-file-transcriber
description: "Transcribe audio files via UniCloud ASR (云知声语音识别, recorded audio → text) API from UniSound. Supports multiple formats, optimized for finance, customer service, and other domains. 调用云知声语音识别服务转写音频文件，支持多种音频格式，适用于金融、客服等场景。Use when the user needs to transcribe recorded audio files, or asks for UniSound/云知声 audio file transcription. Do NOT use for real-time/streaming speech recognition, text-to-speech (TTS), or live captioning. 不适用于实时语音识别、语音合成(TTS)或直播字幕。"
li-feishu-audio
飞书语音交互技能。支持语音消息自动识别、AI 处理、语音回复全流程。需要配置 FEISHU_APP_ID 和 FEISHU_APP_SECRET 环境变量。使用 faster-whisper 进行语音识别，Edge TTS 进行语音合成，自动转换 OPUS 格式并通过飞书发送。适用于飞书平台的语音对话场景。