← Back to Skills Marketplace
36
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install file-organizer-pro
Description
Automatically organize files into folders by type, date, or custom naming rules with preview and undo options.
README (SKILL.md)
Smart File Organizer
一键整理混乱的文件夹。三种模式：按类型、按日期、按命名规则自动归类。
功能
- 按类型归类：图片/文档/视频/音频/压缩包/代码 自动分入对应文件夹
- 按日期归类：按年/年月/年月日创建子目录
- 按命名规律归类：自定义匹配规则
- 预览模式：
--dry-run先看再执行 - 一键撤销：
--undo恢复到整理前
触发词
- 整理文件夹
- 文件归类
- 按类型整理文件
- organize files
- classify files
使用
# 按类型整理
python scripts/main.py --dir D:\Downloads
# 按月份整理照片
python scripts/main.py --dir D:\Photos --method date --date-mode month
# 按规则整理
python scripts/main.py --dir D:\Docs --method pattern --patterns "发票:Invoices,报表:Reports"
# 预览
python scripts/main.py --dir D:\Downloads --dry-run
# 撤销
python scripts/main.py --dir D:\Downloads --undo
依赖
Python >= 3.10，无第三方依赖。
Usage Guidance
Use --dry-run first, choose a non-critical or backed-up folder, and be aware that undo is best-effort and may not restore every edge case such as name collisions. The path mismatch in the docs may require running main.py directly rather than scripts/main.py.
Capability Assessment
Purpose & Capability
The stated purpose is to organize files by type, date, or pattern, and the Python code implements that by iterating only direct files in the chosen target directory, creating category folders, and moving files there.
Instruction Scope
The instructions disclose organizing, dry-run, and undo modes, but they could more prominently warn that normal execution moves files and changes the folder layout; the command-line interface still requires an explicit --dir target.
Install Mechanism
The package metadata and README refer to scripts/main.py while the artifact contains main.py at the root, which may cause installation or invocation confusion but is not a security concern.
Credentials
The behavior is local and proportionate to the purpose: no network calls, no credential handling, no broad recursive indexing, and no access outside the user-selected directory was found.
Persistence & Privilege
The tool writes a local .organizer_log.json undo log inside the target directory and removes it after undo; this is disclosed by the undo feature and is limited persistence.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install file-organizer-pro - After installation, invoke the skill by name or use
/file-organizer-pro - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Fixed slug from malformed smart-file-organizer-v1-0-0smart-file-organizer to clean file-organizer-pro. Updated display name and tags. No functional changes from v1.0.0.
v1.0.0
Initial release of Smart File Organizer.
- Auto-classifies files by type, date, or custom naming patterns.
- Three organizing modes: by type (image, document, video, etc.), by date (year/month/day), or by naming rule.
- Supports preview mode with `--dry-run` and one-click undo with `--undo`.
- Simple command-line interface with no third-party dependencies.
- Includes Chinese-language documentation and usage examples.
Metadata
Frequently Asked Questions
What is Smart File Organizer?
Automatically organize files into folders by type, date, or custom naming rules with preview and undo options. It is an AI Agent Skill for Claude Code / OpenClaw, with 36 downloads so far.
How do I install Smart File Organizer?
Run "/install file-organizer-pro" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Smart File Organizer free?
Yes, Smart File Organizer is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Smart File Organizer support?
Smart File Organizer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Smart File Organizer?
It is built and maintained by mizhimin (@mizhimin); the current version is v1.0.1.
More Skills