Audio Rename

Rename audio files with Chinese/special characters to simple English names for mlx-stt compatibility.

Security Scan

The skill's files and runtime instructions are consistent with its stated purpose: local scripts that rename audio filenames for compatibility, and they do not request credentials or perform network installs.

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.

Assessment

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.

Audio Rename Skill

将带有中文/特殊字符的音频文件重命名为纯英文名称，避免 mlx-stt 等工具处理时出现路径问题。

Usage

推荐使用 Python 版本（更好地处理 Unicode 文件名）：

# 重命名单个文件为默认名称 video_audio.m4a
python3 ${baseDir}/audio-rename.py <文件路径>

# 重命名为指定名称
python3 ${baseDir}/audio-rename.py <文件路径> <新名称>

# 批量重命名目录下所有音频文件
python3 ${baseDir}/audio-rename.py <目录路径> --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, ...