← Back to Skills Marketplace
162
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install audio-rename
Description
Rename audio files with Chinese/special characters to simple English names for mlx-stt compatibility.
README (SKILL.md)
Audio Rename Skill
将带有中文/特殊字符的音频文件重命名为纯英文名称，避免 mlx-stt 等工具处理时出现路径问题。
Usage
推荐使用 Python 版本（更好地处理 Unicode 文件名）：
# 重命名单个文件为默认名称 video_audio.m4a
python3 ${baseDir}/audio-rename.py \x3C文件路径>
# 重命名为指定名称
python3 ${baseDir}/audio-rename.py \x3C文件路径> \x3C新名称>
# 批量重命名目录下所有音频文件
python3 ${baseDir}/audio-rename.py \x3C目录路径> --all
Examples
# 重命名为 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 使用：
# 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, ...
Usage Guidance
This skill appears to do exactly what it says: local filename renaming using small Python and shell scripts, with no network calls or credential use. Before installing or running: (1) Inspect the scripts (they are short and readable). (2) Test in a safe directory or make backups — these scripts rename/move files and there is no dry-run mode. (3) Note the examples: use the --all flag for directory batch operations; passing a shell-expanded glob to the Python script may not behave as expected. (4) If you don't want an agent to run this skill automatically, disable autonomous invocation for the skill or run it manually. If you need stronger guarantees, run the included scripts directly from a terminal rather than letting an agent invoke them.
Capability Analysis
Type: OpenClaw Skill
Name: audio-rename
Version: 1.0.0
The audio-rename skill bundle is a utility designed to rename audio files with non-ASCII characters to simple English names for better compatibility with transcription tools. Both the Python (audio-rename.py) and shell (audio-rename.sh) scripts perform standard file renaming operations using local path manipulation, include logic to prevent overwriting existing files, and contain no evidence of data exfiltration, malicious execution, or prompt injection.
Capability Assessment
Purpose & Capability
Name, description, and included scripts (Python + shell) all implement local filename renaming for audio files. No unrelated binaries, credentials, or services are requested.
Instruction Scope
SKILL.md instructs running the included scripts to rename files and shows a workflow using bili and mlx-stt; this is reasonable. Minor mismatch: examples sometimes show shell globs (e.g., /path/*.m4a) while the Python script expects either a single path or a directory with --all — passing many expanded args may not behave as the examples imply. The instructions do not read secrets, contact remote endpoints, or reference unrelated system paths.
Install Mechanism
No install spec (instruction-only). The code is bundled in the skill (two scripts). No downloads or archives; nothing will be fetched from remote URLs during install.
Credentials
No required environment variables, credentials, or config paths are declared or accessed by the scripts. The skill does not request disproportionate secrets.
Persistence & Privilege
always is false and the skill does not request system-wide persistence or modify other skills. Note: model invocation is enabled by default (disable-model-invocation: false), so an agent with permission to call skills could run these rename operations autonomously — this is a platform default and not unique to this skill.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install audio-rename - After installation, invoke the skill by name or use
/audio-rename - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release
Metadata
Frequently Asked Questions
What is Audio Rename?
Rename audio files with Chinese/special characters to simple English names for mlx-stt compatibility. It is an AI Agent Skill for Claude Code / OpenClaw, with 162 downloads so far.
How do I install Audio Rename?
Run "/install audio-rename" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Audio Rename free?
Yes, Audio Rename is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Audio Rename support?
Audio Rename is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux).
Who created Audio Rename?
It is built and maintained by ayakolin (@ayakolin); the current version is v1.0.0.
More Skills