file-organizer

Organizes directories by analyzing file types, finding duplicates, and restructuring folders.

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

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 analyzes your directories and reorganizes files into a clean, logical structure with your approval at every step. ## Core Features & Use Cases - Directory Analysis: Scans target folders to report file counts, type breakdowns, size distribution, and date ranges using standard shell commands like find, du, and md5. - Duplicate Detection: Finds exact duplicates by hash, same-named files, and similar-sized files, then recommends which copy to keep. - Structured Reorganization: Proposes a folder plan (by type, purpose, or date), waits for confirmation, then moves and renames files with logged changes. - Use Case: Your Downloads folder has 500+ unsorted files. The Skill groups them into Work, Personal, Installers, and Archive folders, flags duplicates for deletion, and gives you a maintenance routine. ## Quick Start Ask the assistant to organize your Downloads folder by sorting files into proper 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?

Point the assistant at 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 approve the plan.

How to find duplicate files on my computer?

Duplicate detection uses md5 hash comparison to find exact copies, plus name and size matching for near-duplicates. Each duplicate set is shown with paths, sizes, and modification dates so you can decide which copy to keep.

Does file organization delete my files without asking?

No. The Skill always asks for confirmation before deleting anything and presents a full organization plan before moving files. All moves are logged so changes can be reviewed or undone.

Can I organize photos by date taken?

Yes. Photos can be sorted into year and month folders based on EXIF metadata or file modification dates, producing a structure like Photos/2024/01-January. Unsorted files go into a separate folder for manual review.

What are the limitations of automated file organization?

The Skill relies on file names, types, and dates, so ambiguous files may need your decision. It works best on common desktop folders and requires shell access for find, du, and md5 commands.