file-organizer

Organizes files and folders by analyzing structure, detecting duplicates, and automating cleanup tasks.

Updated Jul 30, 2026
One-click install
npx skills add https://github.com/johsquaree/claude-basic-docs --skill file-organizer-johsquaree
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-organizer
Source: https://github.com/johsquaree/claude-basic-docs/tree/main/.claude/skills/file-organizer
Command: npx skills add https://github.com/johsquaree/claude-basic-docs --skill file-organizer-johsquaree

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Messy Downloads folders, scattered files, duplicate copies wasting disk space, and illogical folder structures make it hard to find anything. This Skill removes the mental overhead of manual file organization by analyzing your directories and proposing a clean, logical structure. ## Core Features & Use Cases - Directory Analysis & Planning: Scans target folders to summarize file types, sizes, and date ranges, then proposes a structured organization plan for your approval before making any changes. - Duplicate Detection: Finds duplicate files by hash, name, or size and recommends which copies to keep, always asking for confirmation before deletion. - Automated Cleanup & Archiving: Moves, renames, and archives files based on type, purpose, and date, with logged operations and maintenance tips. - Use Case: Your Downloads folder has 500+ unsorted files. Ask the Skill to organize it, and it will group documents, images, installers, and archives into logical subfolders after you approve the plan. ## Quick Start Ask the assistant to organize your Downloads folder by sorting files into logical folders based on their type and content.

Frequently Asked Questions about file-organizer

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

FAQPage Schema
How do I organize a messy Downloads folder automatically?

Ask the assistant to organize your Downloads folder and it will analyze file types, sizes, and dates, then propose a folder structure grouping documents, images, installers, and archives. Files are only moved after you review and approve the plan.

How to find and remove duplicate files on my computer?

Duplicate detection uses checksum comparison via find and md5 to identify exact duplicate files, plus name and size matching for near-duplicates. For each set, you see all paths, sizes, and dates with a recommendation on which copy to keep, and nothing is deleted without your confirmation.

Can I organize photos by date taken automatically?

Yes, photos can be organized into year and month folders based on EXIF metadata or file modification dates. The result is a structure like Photos/2024/01-January with an Unsorted folder for files lacking date information.

Will organizing files delete anything without my permission?

No, the Skill always asks for explicit confirmation before deleting any file, including duplicates. It presents a full organization plan first, logs all move operations for potential undo, and archives old files instead of deleting them by default.

What are the limitations of automated file organization?

Automated organization relies on file names, types, and dates, so ambiguous files may be placed in a To-Sort folder for manual decisions. It cannot judge the semantic importance of files, so sensitive or active project files should be flagged as off-limits before starting.