ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified file management Safety 4/5

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.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/1999azzar/file-organizer-skill
Or

What This Skill Does

The file-organizer-skill is a robust, automated utility designed to declutter local directories by grouping disorganized files into structured folder hierarchies. Whether you are dealing with a download folder filled with disparate file types or a massive repository of unsorted images, this tool provides a methodical way to manage your storage. By leveraging either file extensions or creation dates, the skill organizes content into manageable sub-directories, significantly reducing visual clutter and improving retrieval efficiency. It includes essential safety features such as a dry-run mode for previewing actions before execution and a comprehensive undo feature, ensuring that you remain in full control of your file system integrity.

Installation

To integrate this skill into your environment, use the OpenClaw command line interface. Execute the following command in your terminal: clawhub install openclaw/skills/skills/1999azzar/file-organizer-skill Ensure that you have the necessary environment permissions to read and write to the target directories where you intend to perform organization tasks.

Use Cases

  • Project Archiving: Automatically sort project assets by extension (e.g., .css, .js, .png) after completing a design or development phase.
  • Photo Gallery Management: Utilize the date-sorting feature to organize thousands of camera roll photos into chronological folders by year and month.
  • System Maintenance: Clean up long-neglected 'Downloads' or 'Desktop' folders by moving thousands of loose items into structured categories without manual drag-and-drop operations.
  • Audit Trials: Use the automatically generated organize_history.json to keep a log of every file movement, allowing for verifiable file management.

Example Prompts

  1. "OpenClaw, please organize the contents of my ~/Downloads folder by file extension, but perform a dry-run first so I can see what it will do."
  2. "I need to clean up my photos folder at /Users/me/Pictures/trip. Please use the date sort functionality to organize them by year and month."
  3. "I made a mistake in the last organization process. Can you please undo the changes made in the ~/Projects folder using the history file located there?"

Tips & Limitations

  • Safety First: Always run with the --dry-run flag if you are uncertain about the outcome, especially when working on folders containing critical system files.
  • Custom Mapping: For advanced users, modifying get_default_mapping() in the source script allows you to group custom file types (e.g., specific CAD files or project-specific data formats) into custom categories.
  • Permissions: Ensure the OpenClaw agent has read/write permissions for the target directories. The script cannot modify system-protected files or files currently locked by other running applications.

Metadata

Author@1999azzar
Stars4473
Views1
Updated2026-05-01
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-1999azzar-file-organizer-skill": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Tags(AI)

#file-management#automation#organization#productivity
Safety Score: 4/5

Flags: file-write, file-read, code-execution