🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

File Organizer Skill

by @1999azzar

Organize files in directories by grouping them into folders based on their extensions or date. Includes Dry-Run, Recursive, and Undo capabilities.

Versionv1.0.0
Downloads10,897
Stars⭐ 4
TERMINAL
clawhub install file-organizer-skill

πŸ“– About This Skill


name: 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.

File Organizer (Gold Standard)

Features

  • Smart Sorting: Group by Extension (Default) or Date (Year/Month).
  • Safety: Conflict resolution (auto-rename), Dry Run mode, and Undo capability.
  • Deep Clean: Recursive scanning option.
  • Audit: Generates organize_history.json for tracking.
  • Usage

    Basic Sort (by Extension)

    python3 scripts/organize.py /path/to/folder
    

    Date Sort (Year/Month)

    Great for photos or archives.
    python3 scripts/organize.py /path/to/folder --date
    

    Dry Run (Simulate)

    See what *would* happen without moving anything.
    python3 scripts/organize.py /path/to/folder --dry-run
    

    Undo

    Revert changes using the history file.
    python3 scripts/organize.py --undo /path/to/folder/organize_history.json
    

    Config

    Modify scripts/organize.py get_default_mapping() to add custom extensions.

    πŸ’‘ Examples

    Basic Sort (by Extension)

    python3 scripts/organize.py /path/to/folder
    

    Date Sort (Year/Month)

    Great for photos or archives.
    python3 scripts/organize.py /path/to/folder --date
    

    Dry Run (Simulate)

    See what *would* happen without moving anything.
    python3 scripts/organize.py /path/to/folder --dry-run
    

    Undo

    Revert changes using the history file.
    python3 scripts/organize.py --undo /path/to/folder/organize_history.json
    

    βš™οΈ Configuration

    Modify scripts/organize.py get_default_mapping() to add custom extensions.