← Back to Skills Marketplace
Download Organizer
by
utopiabenben
· GitHub ↗
· v1.0.0
460
Downloads
0
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install download-organizer
Description
下载文件自动分类工具，自动识别文件类型并按类别整理到不同文件夹。适用于整理下载文件夹，自动分类文档、图片、视频、音频、安装包、压缩包等文件！
README (SKILL.md)
Download Organizer - 下载文件自动分类工具
功能特性
- ✅ 自动识别文件类型（文档、图片、视频、音频、安装包、压缩包、代码等）
- ✅ 按文件类型自动分类到不同文件夹
- ✅ 支持自定义分类规则
- ✅ 预览模式（先看效果再执行）
- ✅ 撤销操作（安全可靠）
安装
# 方法一：通过 clawhub 安装
clawhub install download-organizer
# 方法二：作为 Python 脚本运行
git clone \x3Crepo-url>
cd download-organizer
快速开始
1. 整理下载文件夹
download-organizer organize ~/Downloads --output ~/Downloads/Organized
这会自动创建以下文件夹结构，并把文件移动进去：
Organized/
├── documents/
│ ├── report.pdf
│ └── notes.docx
├── images/
│ ├── photo.jpg
│ └── screenshot.png
├── videos/
│ └── movie.mp4
├── audio/
│ └── song.mp3
├── installers/
│ └── app.exe
├── archives/
│ └── files.zip
└── code/
└── script.py
2. 预览模式（不实际执行）
download-organizer organize ~/Downloads --preview
3. 撤销操作
download-organizer undo ~/Downloads/Organized
详细使用说明
organize 命令参数
directory：（必需）要整理的目录，通常是下载文件夹--output：输出目录，默认在输入目录下创建Organized文件夹--preview：预览模式，只显示方案不实际执行
默认文件分类
| 文件夹 | 文件类型 |
|---|---|
| documents | .pdf, .doc, .docx, .txt, .xls, .xlsx, .ppt, .pptx |
| images | .jpg, .jpeg, .png, .gif, .webp, .heic |
| videos | .mp4, .avi, .mov, .mkv |
| audio | .mp3, .wav, .flac, .aac |
| installers | .exe, .msi, .dmg, .pkg, .deb, .rpm |
| archives | .zip, .rar, .7z, .tar, .gz |
| code | .py, .js, .html, .css, .java, .cpp |
配置文件（计划中）
可以在项目根目录创建 .download-organizer.json 来自定义分类规则：
{
"output_dir": "~/Downloads/Organized",
"categories": {
"documents": [".pdf", ".doc"],
"images": [".jpg", ".png"]
},
"backup_original": true
}
示例场景
场景 1：整理下载文件夹
# 整理你的下载文件夹
download-organizer organize ~/Downloads
场景 2：先预览，再执行
# 第一步：预览
download-organizer organize ~/Downloads --preview
# 第二步：确认没问题后执行
download-organizer organize ~/Downloads --output ~/Downloads/Organized
注意事项
- 确保有文件的读写权限
- 建议先用 --preview 预览效果
- 大量文件整理可能需要一些时间
- 整理前建议先备份原文件
更新日志
v1.0.0 (2026-03-06)
- 初始版本发布
- 支持按文件类型自动分类
- 支持预览模式
- 支持撤销操作
Usage Guidance
What to consider before installing/running:
- Source provenance: homepage is missing and registry metadata points to an unknown owner; prefer code from a trusted repo or add a verified homepage/source URL before trusting it.
- Dependency/installation mismatch: the registry declares no required binaries but the README/usage require python3 (and optionally a packaged CLI). Ensure Python is available and know how the CLI is installed (clawhub or manual). The missing repo URL is a red flag for distribution.
- Run safe tests first: use the --preview mode to verify classification, and run against a small test directory (not your real Downloads) to confirm behavior.
- Backup file: the script writes .download-organizer-backup.json inside the output directory containing original->new path mappings. Inspect that file for sensitive path information if that matters, and be aware undo will rely on it.
- Interactive prompt: the script asks for confirmation via input(), which may block automated/non-interactive agent runs; run manually or modify for non-interactive use.
- Review code yourself if possible: the Python source is short and local-only; if you can't verify, run it in a sandbox or VM first.
If these concerns are acceptable (you trust the source or can review/run in a safe environment), the tool's behavior is coherent with its description. Otherwise treat it as untrusted until provenance and install details are clarified.
Capability Analysis
Type: OpenClaw Skill
Name: download-organizer
Version: 1.0.0
The download-organizer skill is a utility designed to categorize files into subdirectories based on their file extensions. The Python script (download_organizer.py) uses standard libraries like pathlib and shutil to copy files and maintains a local JSON backup for its undo functionality; it contains no network calls, obfuscation, or evidence of malicious intent.
Capability Assessment
Purpose & Capability
Name/description match the code: the script scans a directory, classifies files by extension, copies them into categorized folders, and provides preview/undo. No unrelated capabilities (network, external APIs, or extra credentials) are present.
Instruction Scope
SKILL.md instructs running a CLI or python3 script and describes preview/undo. Instructions do not request reading unrelated files or sending data externally. Note: the tool writes a backup file (.download-organizer-backup.json) into the output directory and prompts for interactive confirmation (input()), which can block in non-interactive agent runs.
Install Mechanism
Registry lists no install spec or required binaries, but README and SKILL.md show python3 usage and an installation command (clawhub install) with no repo/homepage provided. This is an inconsistency: the skill will require Python to run and has no declared install/source, making it unclear how the 'download-organizer' CLI would be installed.
Credentials
The skill requires no environment variables, credentials, or external config paths. The code only reads/writes files under the provided input/output directories and creates a local backup file; this is proportional to its purpose.
Persistence & Privilege
The skill does not request persistent/always-on privileges. It writes a backup JSON to the output folder (expected for undo), but it does not modify other skills, system settings, or request global persistence.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install download-organizer - After installation, invoke the skill by name or use
/download-organizer - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
正式版本发布！下载文件自动分类工具，自动识别文件类型并按类别整理到不同文件夹，支持预览模式和撤销功能！
Metadata
Frequently Asked Questions
What is Download Organizer?
下载文件自动分类工具，自动识别文件类型并按类别整理到不同文件夹。适用于整理下载文件夹，自动分类文档、图片、视频、音频、安装包、压缩包等文件！. It is an AI Agent Skill for Claude Code / OpenClaw, with 460 downloads so far.
How do I install Download Organizer?
Run "/install download-organizer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Download Organizer free?
Yes, Download Organizer is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Download Organizer support?
Download Organizer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Download Organizer?
It is built and maintained by utopiabenben (@utopiabenben); the current version is v1.0.0.
More Skills