← Back to Skills Marketplace
Smart File Organizer
by
underbench2-gif
· GitHub ↗
· v1.0.0
977
Downloads
1
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install ub2-smart-file-organizer
Description
Scans and categorizes files in a directory, detects duplicates, and reorganizes them into a clear folder structure with safety features and rollback options.
Usage Guidance
This skill appears to do what it says, but it operates directly on your files — take precautions before running it: (1) use the Dry Run mode first and carefully review the proposed plan; (2) test on a small, non-critical folder before running on important data; (3) avoid pointing it at system directories (/, /etc, user home root) or any directory containing secrets or active project state unless you understand the consequences; (4) confirm where reorganization_log.txt will be written and ensure it does not leak sensitive filenames to an unintended location; (5) confirm the rollback procedure and have backups available (e.g., a full copy or snapshot) in case moves don't preserve metadata or ownership as you expect; (6) check how the agent handles symlinks, permissions, and very large files before broad use. If you need more assurance, ask the skill author (or provide additional SKILL.md detail) about symlink handling, metadata preservation, and the exact rollback mechanism.
Capability Analysis
Type: OpenClaw Skill
Name: ub2-smart-file-organizer
Version: 1.0.0
The provided `_meta.json` contains standard metadata, and `SKILL.md` describes a 'Smart File Organizer' skill. The skill's purpose is to scan, classify, and reorganize files, including duplicate detection. While this involves significant file system interaction, the `SKILL.md` explicitly highlights 'Safety Features' such as a default 'Dry Run Mode', a 'Change Log' (`reorganization_log.txt`), and a strict policy of 'No Deletions' (duplicates are moved, not deleted). There are no instructions in `SKILL.md` that attempt prompt injection against the agent to perform malicious actions, exfiltrate data, establish persistence, or execute unauthorized commands. The described functionality aligns with a legitimate file management utility, presented with clear safety considerations.
Capability Assessment
Purpose & Capability
Name/description align with the instructions: scanning a directory, detecting duplicates, proposing and performing moves, and logging/rollback are all coherent with a 'file organizer' skill. The skill does not request unrelated binaries, env vars, or config paths.
Instruction Scope
SKILL.md stays within the feature set but is high-level and omits operational safeguards: it doesn't specify protections for symlinks, system or hidden files, permission errors, how rollback is implemented, whether metadata (permissions/ownership/timestamps) are preserved, or how very large files are handled. The skill assumes the agent will be granted filesystem access to arbitrary target paths — that is expected for this purpose but warrants user caution.
Install Mechanism
Instruction-only skill with no install steps or external downloads; this minimizes risk from third-party code being written to disk.
Credentials
No environment variables, credentials, or config paths are requested. The filesystem access implied by the instructions is proportional to the stated functionality.
Persistence & Privilege
always is false and the skill does not request persistent/system-wide changes. Autonomous invocation is allowed (platform default) but is not combined with other privilege or credential requests.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ub2-smart-file-organizer - After installation, invoke the skill by name or use
/ub2-smart-file-organizer - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Smart File Organizer 1.0.0 – Initial Release
- Scans directories recursively and catalogs files by size, type, and modification date.
- Automatically classifies files into categories such as documents, images, code, data, archives, and media.
- Detects duplicate files using checksums, and moves duplicates to a dedicated folder.
- Proposes and executes a logical folder structure for better organization.
- Includes dry run mode and comprehensive change logs for safe, traceable reorganization.
- Ensures files are never deleted; all changes can be reviewed and rolled back.
Metadata
Frequently Asked Questions
What is Smart File Organizer?
Scans and categorizes files in a directory, detects duplicates, and reorganizes them into a clear folder structure with safety features and rollback options. It is an AI Agent Skill for Claude Code / OpenClaw, with 977 downloads so far.
How do I install Smart File Organizer?
Run "/install ub2-smart-file-organizer" 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 (open-source). 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 underbench2-gif (@underbench2-gif); the current version is v1.0.0.
More Skills