ClawHub

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.

Audits

Pass
ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install file-organizer-skill

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.