file-organizer

Analyze local directories, detect duplicate files, and organize folders by type.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/dr-code/beacon --skill file-organizer-dr-code
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-organizer
Source: https://github.com/dr-code/beacon/tree/main/plugins/all-skills/skills/file-organizer
Command: npx skills add https://github.com/dr-code/beacon --skill file-organizer-dr-code

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Your local folders become cluttered, files are scattered across locations, and duplicates consume space and attention; this Skill reduces cognitive load by analyzing, grouping, and cleaning files safely and predictably.

Core Features & Use Cases

  • Analyze folder structure: summarizes file counts, types, sizes, and date ranges to reveal organization issues.
  • Duplicate detection: identifies exact and likely duplicates by hash, name, and size and surfaces them for review.
  • Smart reorganization: suggests logical folder hierarchies by type, purpose, or date and prepares a clear plan of moves and renames.
  • Safe automation: executes moves and renames only after confirmation, preserves metadata, logs actions, and avoids destructive deletes without explicit approval.
  • Use cases: clean a messy Downloads folder, restructure project directories, organize photos by date, and prepare archives before backups.

Quick Start

Organize my Downloads folder by file type, find duplicates, and propose a cleanup plan.

Frequently Asked Questions about file-organizer

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

FAQPage Schema
How do I automatically organize files and eliminate duplicates in a cluttered Downloads folder?

To automatically organize files and eliminate duplicates, this Skill analyzes your directory structure, detects duplicates by hash or name, and proposes a safe cleanup plan with automated moves and renames. It executes actions only after your confirmation and logs all changes.

What is the best way to restructure a messy project directory without losing metadata?

The best way to restructure a messy project directory is by generating logical folder hierarchies grouped by type, purpose, or date. This Skill proposes a clear plan of moves and renames, preserving your file metadata while avoiding destructive deletes without explicit approval.

How does duplicate detection work for local files scattered across multiple folders?

Duplicate detection works by analyzing local files across directories to identify exact and likely duplicates using file hashes, names, and sizes. The Skill surfaces these duplicates for your review before executing any safe automated moves or renames.

Can I use this for file organization across local directories like Documents and project folders?

Yes, you can use this for file organization across local directories like Documents, Downloads, and project folders. It performs directory analysis to summarize file counts, types, and sizes, then suggests logical folder hierarchies to reduce clutter predictably.

Does file cleanup automation delete files without my approval?

No, file cleanup automation does not delete files without your explicit approval. The Skill focuses on safe automated moves and renames, requiring your confirmation before executing the reorganization plan and maintaining a log of all actions taken.