Skip to main content
Generaldvcrn

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.

Stars
15
Source
dvcrn/openclaw-skills-marketplace
Updated
2026-05-29
Slug
dvcrn--openclaw-skills-marketplace--file-organizer-skill
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/dvcrn/openclaw-skills-marketplace/HEAD/plugins/1999azzar--file-organizer-skill/skills/file-organizer-skill/SKILL.md -o .claude/skills/file-organizer-skill.md

Drops the SKILL.md into .claude/skills/file-organizer-skill.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

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.