/install claw-file-organizer
File Organizer Skill
Automatically sort, rename, and organize files into structured folders. Reduces chaos in Downloads and any directory with scattered files.
Quick Start
# Install the skill
npx clawhub install file-organizer
# Organize your downloads folder
"Organize my Downloads folder"
# Organize a specific directory
"Organize ~/Documents/projects"
# Undo the last organization
"Undo the last file organization"
Core Features
1. Automatic Sorting
Files are categorized into standard folders:
- Images (
images/) — JPG, PNG, GIF, SVG, WEBP, BMP, TIFF, ICO - Documents (
documents/) — PDF, DOC, DOCX, TXT, RTF, ODT, PPT, PPTX, XLS, XLSX, PPT, ODP - Audio (
audio/) — MP3, WAV, FLAC, OGG, AAC, M4A - Video (
video/) — MP4, MKV, AVI, MOV, WEBM, FLV - Archives (
archives/) — ZIP, TAR, GZ, 7Z, RAR, BZ2, XZ - Code (
code/) — PY, JS, TS, HTML, CSS, MD, JSON, YAML, SH, BAT - Data (
data/) — CSV, JSON, XML, SQL, DB, SQLITE, DAT - Executables (
installers/) — EXE, MSI, DMG, APP, PKG, DEB, RPM, APK - Fonts (
fonts/) — TTF, OTF, WOFF, WOFF2, FON - Other (
other/) — uncategorized files
2. Smart File Renaming
- Extracts dates from filenames (YYYY-MM-DD patterns) and places them in naming
- Converts spaces to underscores for consistency
- Strips special characters (preserving hyphens in compound names)
- Handles duplicate names by appending
_2,_3, etc. - Preserves original extension case (lowercased for consistency)
3. Undo / Restore
- Generates a
ORGANIZE_LOG.jsonafter each operation - Stores original path, new path, and timestamp for every move
undocommand restores files to their exact original locations- Safe: only restores if files haven't been modified since
4. Preview Mode
--dry-runshows what would change without moving files- Reports counts by category and renamed files
- No disk writes in dry-run mode
Configuration
Edit config.yaml to customize:
source_dirs:
- ~/Downloads
target_base: ~/organized-files
auto_sort: true
rename_pattern: "{name}_{date}" # or "none" to skip renaming
max_file_size_mb: 500 # skip files larger than this
exclude_patterns:
- "*.tmp"
- "*.swp"
- ".DS_Store"
- "Thumbs.db"
log_file: ORGANIZE_LOG.json
File Type Patterns
Full mapping is in references/file-patterns.md. You can add custom mappings:
custom_types:
- name: "Design Assets"
folders: "design/"
extensions: [AI, PSD, SKETCH, FIG, INDD]
Safety
- Dry-run first: Always review changes before committing
- Undo-safe: Every move is logged; full restore possible
- Size limits: Skip large files to avoid moving heavy media
- Exclude patterns: Configurable file filters to skip unwanted types
- No data loss: Only moves files; never deletes
Integration
- Works with any directory (Downloads, Documents, Desktop, project roots)
- Integrates with cron-manager for periodic auto-organizing
- Compatible with file-sync workflows
- Output is compatible with cloud storage (consistent naming)
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install claw-file-organizer - After installation, invoke the skill by name or use
/claw-file-organizer - Provide required inputs per the skill's parameter spec and get structured output
What is File Organizer?
Automatically sort and rename files by type into structured folders with undo support, configurable filters, and dry-run preview for safe batch organization. It is an AI Agent Skill for Claude Code / OpenClaw, with 63 downloads so far.
How do I install File Organizer?
Run "/install claw-file-organizer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is File Organizer free?
Yes, File Organizer is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does File Organizer support?
File Organizer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created File Organizer?
It is built and maintained by Indigas (@indigas); the current version is v1.0.0.