Automatically sort cluttered directories into organized subfolders by file extension or creation date.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install file-organizer-skill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install file-organizer-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is File Organizer Skill?
The File Organizer skill provides a professional-grade solution for directory maintenance within the Openclaw Skills framework. It addresses the common problem of cluttered storage by providing automated, rule-based sorting. By leveraging this tool, users can transform messy folders into structured environments, improving both searchability and local storage efficiency.
Built with a focus on reliability, this skill offers comprehensive safety mechanisms to prevent data loss during the organization process. It is an essential utility for anyone managing large volumes of assets, downloads, or archival data who requires a repeatable and safe way to maintain file hygiene.
File Organizer Skill Use Cases
- Managing overcrowded download directories by grouping installers, documents, and media.
- Archiving historical project files by year and month to maintain a clear timeline.
- Cleaning up developer environments where temporary logs and build artifacts accumulate.
- Reverting accidental file movements using the built-in undo system.
How File Organizer Skill Works
- The user specifies a target directory and a sorting strategy, either extension-based or date-based.
- The skill scans the files and determines the appropriate destination folder for each item based on internal mappings.
- A conflict resolution check ensures that no existing files are overwritten during the move by utilizing auto-renaming.
- The organization process is executed, and a local organize_history.json file is generated for audit purposes.
- If the result is not as expected, the user can point the skill back to the history file to restore the original directory state.
File Organizer Skill Setup
To get started with this component of your Openclaw Skills toolkit, ensure you have Python 3 installed and follow these steps:
# Move into the skill directory
cd file-organizer-skill
# Run the organizer on a target path using default extension sorting
python3 scripts/organize.py /path/to/your/files
# To sort by date (Year/Month) instead, use the --date flag
python3 scripts/organize.py /path/to/your/files --date
File Organizer Skill Data Schema & Taxonomy
The skill manages data through the following structure:
| Component | Type | Description |
|---|---|---|
scripts/organize.py |
Script | Contains the core logic and the get_default_mapping() function for extension rules. |
organize_history.json |
Metadata | A JSON-formatted log file created in the target directory that tracks file origins and destinations. |
Output Folders |
Directories | New directories created dynamically (e.g., Documents, 2024/05) based on the chosen sorting logic. |
File Organizer Skill Advanced Features
- Dry Run mode to simulate file movements and preview the final structure without modifying any data on disk.
- Recursive scanning capability to organize deep-nested subfolders and consolidate files into a master structure.
- Robust Undo functionality that uses the JSON history log to perfectly restore the previous file layout.
- Extensible mapping system within the Python script to define custom categories for specialized file types.
- Seamless integration into larger automation workflows powered by Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
clinstagram
A comprehensive hybrid CLI for Instagram that bridges Meta Graph API safety with private API feature depth for AI agents.
Daily Report Generator
A tool that automates the creation of professional work reports by aggregating data from git commits, calendar events, and task managers.
OpenClaw Safe Change Flow
A robust workflow and automation script for making safe configuration changes to OpenClaw instances with automatic rollback capabilities.
UI/UX Pro Max
A comprehensive UI/UX design intelligence skill for building polished, accessible, and implementation-ready web and mobile interfaces.
Guardian Wall
A security-focused skill for sanitizing external content and neutralizing prompt injection attacks in AI agent workflows.
Human Writing
A specialized skill designed to eliminate AI stylistic tells and produce high-density, professional technical documentation.
Featured*
