File Organizer
Use when 用户想诊断 ZSpace NAS 文件库,找出重复文件 + 孤儿文件(只读,不动 NAS)。 触发词:重复文件、孤儿文件、文件整理诊断、哪些文件重复了、哪些文件没归类、找重复电影、找重复照片。 不适用:写操作(删除重复 / 移动孤儿)— 这些走 MCP tool(remove/move/save_file_label)+ LLM 二次确认,不在这 skill 范围。
Install
npx skills add coracoo/zspace_skill --skill file-organizergit clone --depth 1 https://github.com/coracoo/zspace_skill.git /tmp/zspace_skill
mkdir -p ~/.claude/skills
cp -r /tmp/zspace_skill/skills/file-organizer ~/.claude/skills/file-organizerPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# File Organizer — NAS 文件只读诊断 ## 概述 通过组合 NAS MCP tool + `file_organizer.py` 脚本,**只读**诊断文件库的"重复"和"孤儿"问题。 **所有写操作都不在 skill 里** — 报告生成后,用户手动决定怎么处理。 ### 为什么只读 - 删除/移动会丢失数据,需用户确认 - 没法精确反查"哪些文件已打标签"(NAS 端点不暴露 label↔file 关联表) - 诊断先看问题,修复单独做 --- ## 3 个诊断命令 | 命令 | 用途 | 走哪个端点 | |------|------|-----------| | `audit-duplicates` | 扫全盘找重复文件(按 size+ext 弱指纹) | `/v2/file/list` + `/zspool/info` | | `audit-orphans` | 找无标签 + 非影视目录的孤儿文件 | `/v2/file/list` + `/zvideo/classification/dirs` | | `audit-all` | 一键全跑(重复 + 孤儿) | 上面两个一起 | --- ## 工作流 ### 场景 1:用户说"我 NAS 上有没有重复文件" **步骤**: 1. **exec** `python skills/file-organizer/file_organizer.py audit-duplicates --output /tmp/dups.json` 2. 读 stdout 摘要 + JSON 详细清单 3. 报告:总扫描 N 个文件,发现 X 组重复,共 Y 个冗余文件,占用 Z GB 4. 列出前 20 组最大的重复(用户优先处理收益大的) 5. ⚠️ **重要**: 由于使用弱指纹(size+ext),误报率较高,需人工核对后再决定删除 ### 场景 2:用户说"哪些文件没归类" **步骤**: 1. **exec** `python skills/file-organizer/file_organizer.py audit-orphans --output /tmp/orphans.json` 2. 报告:总扫描 N 个文件,X 个孤儿(无标签 + 非影视) 3. 建议处理: - 大文件孤儿 → 考虑删除或归档 - 文档/图片孤儿 → 建议打标签(save_file_label) - 临时/缓存文件 → 候选清理 ### 场景 3:用户说"出综合诊断报告" **步骤**: 1. **exec** `python skills/file-organizer/file_organizer.py audit-all --output /tmp/full-report.json` 2. 读 stdout(给人看) + JSON(详细数据) 3. 两个 section:重复文件诊断 + 孤儿文件诊断 --- ## 关键约束(必读) 1. **只读诊断,不动 NAS** — 这个 skill 是"找出问题",不是"修复" 2. **修复走 MCP tool** — 删/移/打标 用现有 MCP `remove` / `move` / `save_file_label`,LLM 弹 UI 让用户批 3. **`remove` 不进回收站,不可逆** — 处理重复文件时优先 `move` 到 `_to_review/`,人工确认后再删
Details
- Skill name
file-organizer- Repository
- coracoo/zspace_skill
- Path
skills/file-organizer/SKILL.md- License
- MIT
- Repo updated
- 6 August 2026
FAQ
What does the File Organizer skill do?
Use when 用户想诊断 ZSpace NAS 文件库,找出重复文件 + 孤儿文件(只读,不动 NAS)。 触发词:重复文件、孤儿文件、文件整理诊断、哪些文件重复了、哪些文件没归类、找重复电影、找重复照片。 不适用:写操作(删除重复 / 移动孤儿)— 这些走 MCP tool(remove/move/save_file_label)+ LLM 二次确认,不在这 skill 范围。
How do I install the File Organizer skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add coracoo/zspace_skill --skill file-organizer. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is File Organizer popular?
It lives in coracoo/zspace_skill, which has 43 GitHub stars and 13 forks.
Related skills
IOS Memo Bak
43coracoo/zspace_skill
Use when 用户想把 iPhone 备忘录自动备份到 NAS 记事本 — "帮我设置 iPhone 备忘录同步"、"重新告诉我一下怎么配"、"换一个新的备份密钥"、"我同事也要用这个功能"。 触发词:iPhone 备忘录同步、ios 备忘录 bak、备忘录备份到 NAS、备忘 → NAS、iPhone notepad sync、ios 备忘录、备忘录同步、iphone shortcut 备份、iPhone 推笔记、给我配 iPhone 备份、帮我把备忘录同步到 NAS。 不适用:不是直接写 NAS 的 skill — 实际写由 iPhone Shortcut 发起;此 skill 只设置基础设施(生成密钥 + 重启 dashboard + 给配置步骤)。
Label Manager
43coracoo/zspace_skill
管理和查询 ZSpace NAS 标签——按文件名打标(label-manager scan)、按文件内容语义搜打标(RAG)、按标签找文件、新建/删除标签。 触发词:打标签、给 XX 打 XX 标签、按标签找、找所有带 XX 标签的文件、新建标签、删除标签、给 XX 内容的文件打标签、智能打标、语义打标、给一年级的文件打《一年级》标签、给课本打标签、按内容找文件打标、给所有 XX 内容的文件批量打标。 不适用:文件重命名(用 MCP file_rename)、笔记搜索(用 MCP notebook_search)。
Media Naming
43coracoo/zspace_skill
Use when 用户想按命名规范整理影视文件 — "帮我扫一下影视库命名有没有问题"、"电影文件夹名不规范"、"剧集文件名不合规"、"去掉水印/PT名"、"审查规避名怎么还原"、"合集要拆开"。正向合规扫描(scan)+LLM 按规范给出 rename/move 计划;写操作一律走 MCP tool 二次确认。 触发词:影视命名、电影命名规范、剧集命名、文件名不合规、水印文件名、PT原始命名、审查规避、合集拆分、影视库扫描、重命名电影、整理影视文件名、media naming、rename movies。 不适用:极影视分类审计(走 media-organizer)、标签管理(走 label-manager)、找重复/孤儿文件(走 file-organizer)。
Find
40makenotion/cursor-notion-plugin
Quickly find pages or databases in Notion by title keywords. Returns precise matches rather than comprehensive results.
Email Notification
45hungryCodingSir/trade-agent-skills
当用户需要发送邮件时使用此技能——包括发货延迟通知、付款提醒、订单确认、清关提醒等业务邮件。发送前必须确认。
Knowledge Capture
40makenotion/cursor-notion-plugin
Captures conversations and supplied notes as Notion wiki pages, how-to guides, FAQs, decision records, or retrospectives. Use when saving or updating durable knowledge from existing context; use research-documentation when new source discovery and synthesis is the main task.
Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.