file-organizer

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

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/singhaganesh/Urban-assist --skill file-organizer-singhaganesh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-organizer
Source: https://github.com/singhaganesh/Urban-assist/tree/main/.cursor/skills/file-organizer
Command: npx skills add https://github.com/singhaganesh/Urban-assist --skill file-organizer-singhaganesh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Messy directories like Downloads folders accumulate scattered files, duplicates, and inconsistent naming, making it hard to find anything and wasting disk space. ## Core Features & Use Cases - Structure Analysis: Scans target directories to summarize file counts, type breakdowns, size distribution, and date ranges. - Duplicate Detection: Finds exact duplicates via MD5 hashes and similar files by name or size, with recommendations on which copies to keep. - Guided Reorganization: Proposes a folder structure plan, then moves, renames, and archives files only after explicit user approval. - Use Case: Point it at a cluttered Downloads folder and receive a proposed structure (Work, Personal, Archive), a list of duplicates to remove, and a logged set of moves you can review before anything changes. ## Quick Start Ask the assistant to analyze and organize your Downloads folder, find duplicate files, and propose a new folder structure before moving anything.

Frequently Asked Questions about file-organizer

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

FAQPage Schema
How do I find duplicate files in a folder?

Find duplicate files by computing MD5 hashes of every file with the find command and sorting for matching checksums. Files with identical hashes are exact duplicates; you can also compare filenames and sizes to catch near-duplicates.

How to organize a messy Downloads folder automatically?

Start by analyzing the folder's file types, sizes, and date ranges, then group files into categories like Documents, Images, and Archives. Propose the target structure first and move files only after reviewing the plan.

Does file organization delete my files automatically?

No. The workflow always asks for confirmation before deleting anything, including duplicates. All moves are logged so changes can be reviewed or undone, and unexpected situations pause the process for your decision.

What is a good file naming convention for organized folders?

Use descriptive names with ISO dates like 2024-10-17-meeting-notes.md, avoid spaces in favor of hyphens, and remove download artifacts such as '(1)' or 'final-v2'. Prefix folders with numbers like 01-current to control ordering.

When should I archive old files instead of deleting them?

Archive files from projects untouched for six or more months, completed work you may reference later, and anything you are hesitant to delete. Archiving preserves access while keeping active directories clean.