File Organizer

It analyzes existing structures, finds duplicates, suggests improvements, and automates cleanup tasks.

Install

npx promptshop add file-organizer

Details

What This Skill Does

This skill helps users organize their files and folders, creating a clean and logical file structure. It analyzes existing structures, finds duplicates, suggests improvements, and automates cleanup tasks. It's designed for anyone struggling with file management or looking to improve their digital organization.

When to Use

Downloads folder is a chaotic mess Can't find files easily Have duplicate files taking up space Folder structure doesn't make sense Want to establish better organization habits Starting a new project Cleaning up before archiving

Key Features

Analyzes current folder structure to understand content Identifies duplicate files across the system Suggests logical folder structures Automates file moving, renaming, and organizing Makes smart decisions based on file types and dates Identifies old files that may no longer be needed

Manual Installation

Manual installation## When to Use This Skill

Your Downloads folder is a chaotic mess You can't find files because they're scattered everywhere You have duplicate files taking up space Your folder structure doesn't make sense anymore You want to establish better organization habits You're starting a new project and need a good structure You're cleaning up before archiving old projects

Analyzes Current Structure: Reviews your folders and files to understand what you have Finds Duplicates: Identifies duplicate files across your system Suggests Organization: Proposes logical folder structures based on your content Automates Cleanup: Moves, renames, and organizes files with your approval Maintains Context: Makes smart decisions based on file types, dates, and content Reduces Clutter: Identifies old files you probably don't need anymore

How to Use

From Your Home Directory

cd ~

Then run Claude Code and ask for help:

Help me organize my Downloads folder

Find duplicate files in my Documents folder

Review my project directories and suggest improvements

Specific Organization Tasks

Organize these downloads into proper folders based on what they are

Find duplicate files and help me decide which to keep

Clean up old files I haven't touched in 6+ months

Create a better folder structure for my [work/projects/photos/etc]

Instructions

When a user requests file organization help:

Understand the Scope

Ask clarifying questions:

Which directory needs organization? (Downloads, Documents, entire home folder?)
What's the main problem? (Can't find things, duplicates, too messy, no structure?)
Any files or folders to avoid? (Current projects, sensitive data?)
How aggressively to organize? (Conservative vs. comprehensive cleanup)

Analyze Current State

Review the target directory:

Get overview of current structure

ls -la [target_directory]

Check file types and sizes

find [target_directory] -type f -exec file {} ; | head -20

Identify largest files

du -sh [target_directory]/* | sort -rh | head -20

Count file types

find [target_directory] -type f | sed 's/.*.//' | sort | uniq -c | sort -rn

Summarize findings:

Total files and folders
File type breakdown
Size distribution
Date ranges
Obvious organization issues

Identify Organization Patterns

Based on the files, determine logical groupings:

By Type:

Documents (PDFs, DOCX, TXT)
Images (JPG, PNG, SVG)
Videos (MP4, MOV)
Archives (ZIP, TAR, DMG)
Code/Projects (directories with code)
Spreadsheets (XLSX, CSV)
Presentations (PPTX, KEY)

By Purpose:

Work vs. Personal
Active vs. Archive
Project-specific
Reference materials
Temporary/scratch files

By Date:

Current year/month
Previous years
Very old (archive candidates)

Find Duplicates

When requested, search for duplicates:

Find exact duplicates by hash

find [directory] -type f -exec md5 {} ; | sort | uniq -d

Find files with same name

find [directory] -type f -printf '%f\n' | sort | uniq -d

Find similar-sized files

find [directory] -type f -printf '%s %p\n' | sort -n

For each set of duplicates:

Show all file paths
Display sizes and modification dates
Recommend which to keep (usually newest or best-named)
Important: Always ask for confirmation before deleting

Propose Organization Plan

Present a clear plan before making changes:

Organization Plan for [Directory]

Current State

X files across Y folders
[Size] total
File types: [breakdown]
Issues: [list problems]

Proposed Structure

[Directory]/ ├── Work/ │ ├── Projects/ │ ├── Documents/ │ └── Archive/ ├── Personal/ │ ├── Photos/ │ ├── Documents/ │ └── Media/ └── Downloads/ ├── To-Sort/ └── Archive/

Changes I'll Make

Create new folders: [list]
Move files:
- X PDFs → Work/Documents/
- Y images → Personal/Photos/
- Z old files → Archive/
Rename files: [any renaming patterns]
Delete: [duplicates or trash files]

Files Needing Your Decision

[List any files you're unsure about]

Ready to proceed? (yes/no/modify)

Execute Organization

After approval, organize systematically:

Create folder structure

mkdir -p "path/to/new/folders"

Move files with clear logging

mv "old/path/file.pdf" "new/path/file.pdf"

Rename files with consistent patterns

Example: "YYYY-MM-DD - Description.ext"

Important Rules:

Always confirm before deleting anything
Log all moves for potential undo
Preserve original modification dates
Handle filename conflicts gracefully
Stop and ask if you encounter unexpected situations

Provide Summary and Maintenance Tips

After organizing:

Organization Complete! ✨

What Changed

Created [X] new folders
Organized [Y] files
Freed [Z] GB by removing duplicates
Archived [W] old files

New Structure

[Show the new folder tree]

Maintenance Tips

To keep this organized:

Weekly: Sort new downloads
Monthly: Review and archive completed projects
Quarterly: Check for new duplicates
Yearly: Archive old files

Quick Commands for Youbash

Find files modified this week

find . -type f -mtime -7

Sort downloads by type

[custom command for their setup]

Find duplicates

[custom command] Want to organize another folder?

Examples

Example 1: Organizing Downloads (From Justin Dielmann)

User: "My Downloads folder is a mess with 500+ files.
Help me organize it.".

Process: Analyzes Downloads folder Finds patterns: work docs, personal photos, installers, random PDFs Proposes structure:

Downloads/
- Work/
- Personal/
- Installers/ (DMG, PKG files)
- Archive/
- To Sort/ (things needing decisions) Asks for confirmation Moves files intelligently based on content and names Results: 500 files → 5 organized folders

Example 2: Finding and Removing Duplicates

User: "Find duplicate files in my Documents and help me decide which to keep."

Output:

Found 23 Sets of Duplicates (156 MB total)

Duplicate Set 1: "proposal.pdf"

/Documents/proposal.pdf (2.3 MB, modified: 2024-03-15) /Documents/old/proposal.pdf (2.3 MB, modified: 2024-03-15) /Desktop/proposal.pdf (2.3 MB, modified: 2024-03-10)

Recommendation: Keep /Documents/proposal.pdf (most recent in correct location) Delete the other 2 copies?

[Continue for all duplicates...]