← Back to Skills Marketplace
File Organizer Skill
by
azzar budiyanto
· GitHub ↗
· v1.0.0
10373
Downloads
4
Stars
62
Active Installs
1
Versions
Install in OpenClaw
/install file-organizer-skill
Description
Organize files in directories by grouping them into folders based on their extensions or date. Includes Dry-Run, Recursive, and Undo capabilities.
Usage Guidance
Run --dry-run first, choose a narrow target folder, use --recursive deliberately, and only run --undo with an organize_history.json generated by this script from a folder you trust. Do not use undo logs from downloads, chat messages, or other people.
Capability Analysis
Type: OpenClaw Skill
Name: file-organizer-skill
Version: 1.0.0
The `scripts/organize.py` skill is suspicious due to a critical file movement vulnerability in its `undo` functionality. The `undo` function takes a user-supplied `log_file` path without sufficient validation. This `log_file` is parsed as JSON, and its `src` and `dst` fields are directly used in `shutil.move(dst, src)`. An attacker could craft a malicious `organize_history.json` file containing arbitrary `src` and `dst` paths, allowing them to move any file on the system (e.g., `/etc/passwd` to `/tmp/backup` or vice-versa) by executing the skill with the `--undo` flag, leading to potential data tampering, denial of service, or privilege escalation.
Capability Assessment
Purpose & Capability
Moving files into category or date folders is coherent with the stated file-organizer purpose; recursive mode can affect many files under the chosen directory.
Instruction Scope
The instructions disclose dry-run, recursive, audit history, and undo behavior, but they do not clearly warn that undo trusts the history file contents.
Install Mechanism
No install-time execution, remote download, dependency installation, or hidden setup behavior was found; the artifact contains documentation, a reference file, and one Python standard-library script.
Credentials
Local filesystem read/write access is expected for a file organizer and normal runs are scoped to the user-provided directory; no network, credential, or profile access was found.
Persistence & Privilege
The script writes organize_history.json in the target directory for undo, and the undo path reads and then deletes the provided log file after processing.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install file-organizer-skill - After installation, invoke the skill by name or use
/file-organizer-skill - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the File Organizer skill.
- Organize files by extension (default) or by date (year/month).
- Supports dry run mode to preview changes without moving files.
- Includes recursive scanning and undo functionality.
- Tracks actions in an organize_history.json file for audit and undo.
Metadata
Frequently Asked Questions
What is File Organizer Skill?
Organize files in directories by grouping them into folders based on their extensions or date. Includes Dry-Run, Recursive, and Undo capabilities. It is an AI Agent Skill for Claude Code / OpenClaw, with 10373 downloads so far.
How do I install File Organizer Skill?
Run "/install file-organizer-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is File Organizer Skill free?
Yes, File Organizer Skill is completely free (open-source). You can download, install and use it at no cost.
Which platforms does File Organizer Skill support?
File Organizer Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created File Organizer Skill?
It is built and maintained by azzar budiyanto (@1999azzar); the current version is v1.0.0.
More Skills