music-organizer SKILL.md skillA
music-organizer from skyzhao1223/zspace-cli is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add skyzhao1223/zspace-cli/music-organizer@git:20261009.f321c25Pins git:20261009.f321c25 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- skyzhao1223/zspace-cli
- Path
src/zspace_cli/skills/music-organizer/SKILL.md- Versions recorded
- 3
- Latest version
- git:20261009.f321c25, committed Oct 9, 2026
- First version recorded
- Sep 20, 2026
- Size
- 21,359 bytes
- Repository stars
- 27
- License
- MIT
Use when 用户想整理 NAS 上的音乐库 — "帮我整理音乐"、"歌曲散落一地"、"专辑没有封面"、"文件名带【FLAC】/320K 水印"、"曲目没有编号"、"路径和 ID3 标签对不上"。只读扫描按「歌手/专辑/曲目」三层结构做正向合规校验,内置最小 ID3v2 解析器可选对照路径与标签;LLM 出 old→new 计划,用户确认后由 Agent 执行。.
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
# Music Organizer — 音乐库正向合规整理
## 概述
**跨 NAS 通用**:扫描脚本跑在**本地挂载路径**上(SMB/NFS),纯 stdlib 零依赖,
不绑定任何品牌 API。内置**最小 ID3v2 解析器**(纯 Python,读 mp3 标签),
无需 mutagen/eyeD3 等第三方库。
对音乐库做**正向合规扫描**:定义合规结构(歌手/专辑/曲目)→ 不匹配即报问题。
**写操作不在脚本里** — 扫描出问题后,LLM 生成 `old → new` 计划,
经用户确认后由 Agent 执行(挂载盘 `mkdir`/`mv -n`,极空间也可走 `zs` CLI / MCP tool)。
## Prerequisites
```bash
open smb://<NAS_IP>/音乐 # 极空间/群晖/威联通/绿联等均支持 SMB
python3 --version # ≥3.9 即可,无第三方依赖
```
## 快速验证
```bash
python3 music_organizer.py scan --root /Volumes/nas/音乐 --sample 500
```
## 命令
| 命令 | 用途 |
|------|------|
| `scan --root PATH` | 正向合规扫描(只读) |
| `scan --root PATH --json --output F` | JSON 输出 |
| `--read-tags` | 读 mp3 ID3v2 标签,对照路径与标签一致性(较慢,默认最多 100 文件) |
| `--tag-limit N` | `--read-tags` 时最多读取的文件数 |
| `--max-depth N` / `--sample N` / `--top N` | 深度 / 文件数上限 / 每类显示条数 |
| (同目录 `config.json`) | 可选覆盖层:目录白名单 + 扩展名改判,见下「配置覆盖」。**没有这个文件时行为与旧版逐字节一致** |
期望目录结构:
```
音乐/
周杰伦/ ← 歌手
范特西 (2001)/ ← 专辑(建议带年份)
01 爱在西元前.mp3 ← 曲目号前缀
02 简单爱.mp3
cover.jpg ← 专辑封面
范特西.cue ← 整轨镜像的 CUE(合法)
…Read the whole file at its exact version.
How to install
mdr add skyzhao1223/zspace-cli/music-organizer@sha256:f7c6a0d765e36b07The line at the top of this page pins the label git:20261009.f321c25, 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_7etf6vwvqilcvcfc)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 3 versions of this file, between Sep 20, 2026 and Oct 9, 2026, about one every 10 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261009.f321c25 latest | 2026-10-09 | f321c25 | 21,359 B | A | view · diff |
| git:20261008.aae65c7 | 2026-10-08 | aae65c7 | 8,817 B | A | view · diff |
| git:20260920.d4bf53a | 2026-09-20 | d4bf53a | 8,306 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 (21359 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
skyzhao1223/zspace-cli · 27 stars · license MIT · pushed 2026-10-09 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_7etf6vwvqilcvcfc GET https://markdownregistry.com/api/v1/resolve?ref=skyzhao1223/zspace-cli/music-organizer GET https://markdownregistry.com/api/v1/blob/f7c6a0d765e36b07a349a3922169345525e82e371c1772730b5a84ed65ea3845
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.
More from skyzhao1223/zspace-cli
Every file in skyzhao1223/zspace-cli