前言¶
下载目录、桌面或项目旁的「临时堆」里，混着 PDF、截图、压缩包和零散脚本。手工建子目录再拖拽，路径一多就容易漏文件或分错类。用脚本按扩展名批量 mv 可以自动化，但你要自己维护分类表，还要处理边界格式和误移动。
下面介绍 SkillHub 上的社区 Skill「文件自动整理助手」（@user_d0b67476/file-organizer-gjn）。它把「按类型分到不同子文件夹」写成 Agent 可遵循的 SKILL 说明，由对话指定目标目录后，由 Agent 按文档、图片、代码、压缩包、视频等类别完成整理，并声明支持多种格式的识别。无需 API Key（requires_api_key=false）。
这是什么¶
文件自动整理助手是面向办公效率（office-efficiency）的社区 Skill，坐标 @user_d0b67476/file-organizer-gjn，当前版本 1.0.0，发布者为 user_d0b67476，来源标注为 community。
官方简介：整理指定文件夹中的文件，按文档、图片、代码、压缩包、视频等类型分类到不同子文件夹中，支持多种格式文件识别。
SkillHub 页面统计（以页面展示为准）：评分 100000，下载 1513，安装 0。
- 技能页：https://www.skillhub.cn/skills/user_d0b67476/file-organizer-gjn
- API 条目：https://api.skillhub.cn/user_d0b67476/file-organizer-gjn
核心功能¶
依据 SkillHub 已公开说明，可核实的能力如下：
- 指定目录整理：对用户给出的文件夹进行归类，而不是泛泛描述「整理电脑」。
- 按类型分子目录：至少覆盖文档、图片、代码、压缩包、视频等类别，每类对应子文件夹。
- 多格式识别：在简介中声明支持多种文件格式的识别，具体扩展名列表以安装后的
SKILL.md为准。
未在官方简介中出现的功能（例如按日期归档、试运行预览、自定义规则、回滚等）本文不写，避免与包内说明不一致。
安装与启用¶
该 Skill 基于通用 SKILL.md 格式，需安装到当前 Agent 能加载的 skills 目录后才会生效。SkillHub 提供两种常见路径。
方式一：让 Agent 按官方提示安装（页面推荐）¶
SkillHub 技能页给出的安装提示为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_d0b67476/file-organizer-gjn`。
将上述内容发给 Cursor、Claude Code 等支持 Skills 的客户端中的 Agent，由它读取安装文档并完成拉取与目录放置。
方式二：使用 SkillHub CLI¶
若本机已有 skillhub，可按 SkillHub 安装与优先源配置 操作。先确认 CLI：
command -v skillhub && skillhub --version
未安装时，文档提供的完整安装命令为：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。文档列出的常用路径包括：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
通用安装形式为：
skillhub install <技能标识> --dir <skills 目录>
具体子命令参数以 skillhub.md 与 CLI 帮助为准；坐标以 @user_d0b67476/file-organizer-gjn 为准。
安装或更新 skills 后，按你所用客户端的要求重启或刷新，使新 Skill 进入上下文。
典型用法¶
官方公开材料未附带逐步对话脚本，可复现的用法与简介一致，可按下面步骤与 Agent 协作：
- 确认 文件自动整理助手 已出现在当前环境的 skills 列表中。
- 明确目标文件夹的绝对路径（例如下载目录或桌面某文件夹），并说明是否包含子目录（若 SKILL 内有更细规则，以包内文档为准）。
- 用自然语言提出整理需求，例如：「用文件自动整理助手，把这个文件夹里的文件按类型分到子文件夹里。」
- 在 Agent 执行移动前，自行确认路径无误；重要数据建议先备份或复制到别处再整理。
整理结果预期为：原目录下出现按文档、图片、代码、压缩包、视频等划分的子文件夹，文件按类型迁入对应目录。
适用场景与注意¶
适合谁
- 经常把文件丢进同一目录、事后需要按类型归档的开发者或办公用户。
- 已在使用 Cursor、Claude Code 等 Agent，希望用对话代替手写
mv脚本的用户。
使用注意
- 本 Skill 不需要 API Key，不依赖外部付费接口即可完成本地文件归类（以标签
requires_api_key=false为准）。 - 社区来源（
community），行为细节以安装包内SKILL.md为最终依据；升级前可看 SkillHub 上的版本号（当前 1.0.0）。 - 批量移动文件有风险：路径写错、误移系统目录或正在使用的项目文件会造成损失，执行前核对目标路径并做好备份。
- SkillHub 显示的安装量为 0，仅表示平台统计，不代表 Skill 不可用；若 CLI 安装失败，可优先采用页面推荐的 Agent 安装提示。
结尾¶
文件自动整理助手把「按类型分子文件夹」收敛成一条可安装的 Agent Skill：指定目录、按文档/图片/代码/压缩包/视频等归类，并声明多格式识别，适合整理堆积的本地文件夹。无需 API Key，通过 SkillHub 安装后即可在对话中触发。
官方入口：https://www.skillhub.cn/skills/user_d0b67476/file-organizer-gjn
