← Back to Skills Marketplace
File Organizer Skill
by
azzar budiyanto
· GitHub ↗
· v1.0.0
12399
Downloads
4
Stars
0
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
Install only if you are comfortable with a local script that moves files. Use dry-run first, run it only on directories you explicitly choose, avoid recursive mode on broad folders, and do not use --undo with a history file you did not create and inspect.
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
Credentials
Moving files is expected for this skill, but the undo implementation can relocate any file accessible to the running user if given a crafted history file, which is broader than the documented folder-scoped workflow.
Install Mechanism
The artifact is a simple skill with Markdown instructions, one local Python script, and one reference file; no package install, remote retrieval, or dependency setup was found.
Instruction Scope
The normal organize path is user-directed, but undo accepts any log file path and replays src/dst entries without validating that the file was generated by this tool or that paths stay within the organized directory.
Persistence & Privilege
No services, hooks, scheduled tasks, credential access, or network behavior were found; the only persistence is an organize_history.json audit file, which undo deletes after running.
Purpose & Capability
The core capability matches the stated purpose: it sorts files by extension or date, supports dry run, recursion, conflict renaming, history logging, and undo.
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 12399 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