← Back to Skills Marketplace
sxliuyu

File Auto Organizer

by SxLiuYu · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
1625
Downloads
1
Stars
5
Active Installs
1
Versions
Install in OpenClaw
/install file-auto-organizer
Description
文件自动整理工具。按文件类型、日期自动归类下载文件夹,适合整理控和洁癖用户。
README (SKILL.md)

File Auto Organizer 📁

自动整理文件夹,按类型/日期归类文件,告别凌乱桌面!

功能

  • 📂 按文件类型自动归类(图片、文档、视频、压缩包等)
  • 📅 按日期整理(今天、昨天、本周等)
  • 🔍 支持自定义规则
  • 🗑️ 可选:删除重复文件
  • 📊 整理报告

使用方法

整理下载文件夹

python3 scripts/organizer.py organize ~/Downloads

按类型整理

python3 scripts/organizer.py by-type ~/Downloads

按日期整理

python3 scripts/organizer.py by-date ~/Downloads

查看统计

python3 scripts/organizer.py stats ~/Downloads

规则说明

默认类型分类:

  • 🖼️ 图片: jpg, png, gif, webp, svg, psd, ai
  • 📄 文档: pdf, doc, docx, txt, md, xls, xlsx, ppt, pptx
  • 📦 压缩包: zip, rar, 7z, tar, gz
  • 🎬 视频: mp4, mkv, avi, mov, flv
  • 🎵 音频: mp3, wav, flac, aac
  • 💻 代码: js, py, java, cpp, html, css

示例

# 整理桌面
python3 scripts/organizer.py organize ~/Desktop

# 整理并生成报告
python3 scripts/organizer.py organize ~/Downloads --report
Usage Guidance
This skill appears to be what it says: a local script that moves files into subfolders by type/date and prints stats. Before running it on important folders: (1) back up or test on a copy (it will move files, which can be disruptive), (2) run it on a small sample directory first to confirm behavior, (3) be aware there is no network activity or secret access, but SKILL.md mentions deleting duplicates while the script does not implement explicit duplicate deletion, and (4) ensure you have python3 available and review the script if you want additional safety (dry-run, confirmations, undo, or true duplicate-detection) before use.
Capability Analysis
Type: OpenClaw Skill Name: file-auto-organizer Version: 1.0.0 The skill is a standard file organization tool that categorizes files by type or date. The Python script (scripts/organizer.py) uses standard library functions like shutil.move and pathlib to manage files and contains no network activity, data exfiltration, or obfuscated code.
Capability Assessment
Purpose & Capability
Name/description, SKILL.md, and the included Python script all align: organizing files by type/date and showing stats. Minor metadata inconsistency: registry header listed no required binaries while _meta.json declares 'python3' as a required bin. This is expected (the script needs Python) but should be reconciled.
Instruction Scope
SKILL.md instructs running the bundled script against a user-specified folder. The script only reads file metadata and moves files within the target folder (creates category/date subfolders, renames to avoid overwrite). It does not access environment variables, network endpoints, or unrelated system paths. Note: SKILL.md mentions an optional 'delete duplicate files' feature but the included script does not implement explicit duplicate-deletion behavior; also there is no dry-run/safety prompt — the script will move files immediately.
Install Mechanism
No install spec; instruction-only with a bundled Python script. No external downloads or archives. Risk is limited to running the provided script locally.
Credentials
No credentials or environment variables are requested. The only runtime dependency is Python (python3). This is proportionate to the stated purpose.
Persistence & Privilege
Skill is not always-enabled and does not request elevated or persistent platform privileges. It does not modify other skills or global agent settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install file-auto-organizer
  3. After installation, invoke the skill by name or use /file-auto-organizer
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of file-auto-organizer. - Automatically organizes files by type (images, documents, videos, etc.) and date (today, yesterday, week). - Supports custom classification rules. - Optional removal of duplicate files. - Generates organization reports. - Simple command-line usage for organizing Downloads, Desktop, and more.
Metadata
Slug file-auto-organizer
Version 1.0.0
License MIT-0
All-time Installs 5
Active Installs 5
Total Versions 1
Frequently Asked Questions

What is File Auto Organizer?

文件自动整理工具。按文件类型、日期自动归类下载文件夹,适合整理控和洁癖用户。 It is an AI Agent Skill for Claude Code / OpenClaw, with 1625 downloads so far.

How do I install File Auto Organizer?

Run "/install file-auto-organizer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is File Auto Organizer free?

Yes, File Auto Organizer is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does File Auto Organizer support?

File Auto Organizer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created File Auto Organizer?

It is built and maintained by SxLiuYu (@sxliuyu); the current version is v1.0.0.

💬 Comments