前言¶

本地音乐库常见问题是文件散落、文件名与标签不一致、缺少统一的艺人/专辑目录结构。手工用播放器改元数据、再拖文件夹整理，曲目一多就很耗时，也容易漏文件。

下面介绍 SkillHub 上的社区 Skill「音乐信息整理」（@user_284ffaa5/music-organizer，v1.0.0）。它面向「给定一个目标文件夹」的场景：扫描其中的音频、读取或修复元数据标签、按艺人/专辑自动分类，并生成音乐库报告。安装后由 Agent 按 Skill 说明执行，参数为「目标文件夹路径」和「操作模式」。

这是什么¶

「音乐信息整理」是 SkillHub 社区来源（community）的 Agent Skill，发布者为 user_284ffaa5，分类为 office-efficiency（办公效率）。SkillHub 页面标注 requires_api_key=false，即不依赖额外 API Key 即可使用。

一句话定位：在指定目录内批量处理音频文件的标签与目录结构，并输出库级报告，适合把「整理音乐库」交给 Agent 按固定流程完成，而不是每次手写脚本或逐首改标签。

核心功能¶

以下能力均来自 SkillHub 官方简介，未在页面单独展开的实现细节不作延伸描述。

1. 扫描目录中的音频文件
   对传入的目标文件夹做扫描，识别其中的音频资源。

2. 读取 / 修复元数据标签
   读取现有标签；在标签缺失或错误时进行修复（具体字段与修复规则以安装后的 SKILL.md 为准）。

3. 按艺人 / 专辑自动分类
   依据元数据将文件整理到艺人、专辑相关的目录结构中。

4. 生成音乐库报告
   整理过程结束后输出音乐库报告，便于核对扫描范围与分类结果。

调用时需提供的参数为：[目标文件夹路径]、[操作模式]。官方资料未列出各操作模式的枚举名称，使用前请在 Agent 中打开已安装 Skill 的说明，或向 Agent 说明目标路径与期望行为（例如仅扫描、修复标签、完整归档等）。

安装与启用¶

SkillHub 推荐通过官方安装文档与 CLI 安装，坐标为 @user_284ffaa5/music-organizer。

1. 安装 SkillHub CLI（若尚未安装）¶

command -v skillhub && skillhub --version

未安装时可执行完整安装（CLI + 默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2. 安装本 Skill 到当前 Agent 的 skills 目录¶

安装时必须使用 --dir 指向当前 Agent 识别的 skills 目录，否则默认会装到 ./skills/，Agent 可能无法加载。

skillhub install @user_284ffaa5/music-organizer --dir <你的 Agent skills 目录>

常用路径（来自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

也可将下面提示词发给 AI，让其按安装文档完成安装（与 SkillHub 技能页一致）：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_284ffaa5/music-organizer`。

安装完成后，按你所用客户端的要求重启或刷新 Agent，使 Skill 生效。

典型用法¶

官方页面未提供独立命令行子命令示例，典型流程是：先安装 Skill → 在对话中指定目标文件夹与操作模式。

可复现的表述方式示例（路径请换成你本机实际目录）：

已安装 @user_284ffaa5/music-organizer。请对目录 /path/to/my-music 执行音乐信息整理，
操作模式：<按 SKILL.md 中支持的模式填写，例如完整整理并生成报告>。

建议先在副本目录或少量文件上试跑，确认标签修复与移动/分类规则符合预期，再对完整音乐库执行。

适用场景与注意¶

适合谁

• 本地有大量音频文件、目录混乱或标签不统一的用户。
• 希望用 Agent 固定一套「扫描 → 修标签 → 按艺人/专辑分类 → 报告」流程，减少重复手工操作的人。

使用注意

• 备份：涉及移动文件与改写标签，操作前请备份目标目录或使用副本试跑。
• 操作模式：第二个参数为「操作模式」，具体取值以安装包内 Skill 说明为准；资料中未公开枚举时，不要假设存在某种未文档化的模式。
• 社区 Skill：来源为社区，版本当前为 v1.0.0；行为以实际 SKILL.md 与 Agent 执行为准。
• 统计信息：SkillHub 抓取资料显示评分为 100000、下载 974 次（页面统计会变动，以 SkillHub 实时显示为准）。

结尾¶

「音乐信息整理」把音乐库整理的重复步骤封装成 Agent Skill：扫描音频、处理元数据、按艺人/专辑归类并出报告，参数只需目标路径与操作模式，且无需 API Key。若你正在整理本地曲库，可从 SkillHub 安装 @user_284ffaa5/music-organizer 后在 Agent 中指定目录试用。

• SkillHub 技能页：https://www.skillhub.cn/skills/user_284ffaa5/music-organizer
• API 坐标页：https://api.skillhub.cn/user_284ffaa5/music-organizer