file-organizer-skill

Organize files into folders by extension or date with dry-run and undo support.

1|Updated May 10, 2026
One-click install
npx skills add https://github.com/Tgoldi/claude-skills --skill file-organizer-skill-tgoldi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-organizer-skill
Source: https://github.com/Tgoldi/claude-skills/tree/main/file-organizer-skill
Command: npx skills add https://github.com/Tgoldi/claude-skills --skill file-organizer-skill-tgoldi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Messy directories full of mixed file types are hard to navigate and maintain. This Skill automatically sorts files into categorized folders by extension or date, eliminating manual cleanup work. ## Core Features & Use Cases - Extension-Based Sorting: Groups files into category folders like Images, Documents, Audio, Video, Archives, Code, and Executables based on file extensions. - Date-Based Sorting: Organizes files into Year/Month folder structures using file modification timestamps, ideal for photo archives. - Safety Controls: Dry-run mode previews changes without moving anything, automatic conflict resolution renames duplicates, and an undo function restores original locations from a history log. - Use Case: Point it at a cluttered Downloads folder to instantly sort hundreds of files into clean category folders, preview the result first with dry-run, and revert everything if needed. ## Quick Start Ask the AI to organize the files in a specific folder by extension, optionally requesting a dry run first to preview the changes.

Frequently Asked Questions about file-organizer-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I organize files into folders by extension with Python?

Run the organize.py script with a target directory path to sort files into category folders like Images, Documents, and Code based on their extensions. Use the --dry-run flag first to preview all moves without changing anything.

How to sort photos into folders by year and month?

Use the --date flag when running the organizer script. It reads each file's modification timestamp and moves it into a Year/Month folder structure such as 2024/03-March, which works well for photo archives.

Can I undo file organization after moving files?

Yes, the script saves every move to an organize_history.json file in the target directory. Run the script with the --undo flag pointing to that history file to restore all files to their original locations.

What happens when files have duplicate names during organization?

The script automatically resolves naming conflicts by appending a counter suffix to the filename, such as report_1.pdf, so no existing file is ever overwritten during the move.

Does the file organizer scan subfolders recursively?

By default it only processes files in the top level of the target directory. Add the --recursive flag to perform a deep scan that processes files in all nested subfolders as well.