file-organizer

Organize messy folders by analyzing and restructuring file hierarchies.

6|2|Updated Jan 6, 2026
One-click install
npx skills add https://github.com/acaprino/alfio-claude-plugins --skill file-organizer-acaprino
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-organizer
Source: https://github.com/acaprino/alfio-claude-plugins/tree/main/plugins/utilities/skills/file-organizer
Command: npx skills add https://github.com/acaprino/alfio-claude-plugins --skill file-organizer-acaprino

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you reclaim space and mental bandwidth by turning chaotic folders into a clean, logical structure without manual drudgery.

Core Features & Use Cases

  • Automated classification: analyzes your Downloads, Documents, and Projects to group files by type and purpose.
  • Duplicate detection and cleanup: identifies repeated files and suggests which copies to keep.
  • Non-destructive planning: proposes a folder structure and logs actions for your approval before moving anything.
  • One-click maintenance: runs periodic cleanups to preserve organization over time.

Quick Start

Run the organizer on a target directory to categorize files, for example: organize --path ~/Downloads --mode casual Review proposed changes and approve to apply.

Frequently Asked Questions about file-organizer

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

FAQPage Schema
How do I organize messy folders and clean up file clutter automatically?

To organize messy folders automatically, you run the organizer on a target directory so it analyzes file hierarchies, groups files by type and purpose, and proposes a new structure for your approval before moving anything.

What is non-destructive file restructuring and how does it work for directory cleanup?

Non-destructive file restructuring means the tool proposes a folder structure and logs all actions for your approval before moving anything, ensuring your original files are safe until you explicitly accept the plan.

Can I detect and remove duplicate files in my Downloads and Documents folders?

Yes, you can detect and remove duplicate files in your Downloads and Documents folders; the tool identifies repeated files and suggests which copies to keep as part of its automated classification process.

How do I configure rules to sort files by type and date in my project folders?

You can configure rules by type and date to sort files in your project folders by running the organizer with specific modes, allowing you to categorize and restructure file hierarchies according to your custom criteria.

Does this folder organizer work for both home directories and project folders?

Yes, this folder organizer works for both home directories and project folders, applying its automated classification, duplicate detection, and non-destructive planning to any messy target path you specify.

What is the best way to maintain an organized folder system over time?

The best way to maintain an organized folder system is to run periodic cleanups; the tool applies one-click maintenance to preserve your structure over time by re-analyzing directories and logging new actions for approval.