file-organizer

Analyze directories, detect duplicates, and organize files with user confirmation.

4|Updated Dec 7, 2025
One-click install
npx skills add https://github.com/icartsh/icartsh_plugin --skill file-organizer-icartsh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-organizer
Source: https://github.com/icartsh/icartsh_plugin/tree/main/icartsh-plugin/skills/file-organizer
Command: npx skills add https://github.com/icartsh/icartsh_plugin --skill file-organizer-icartsh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill acts as a personal file-organizing assistant to create logical structures, remove duplicates, and archive stale items.

Core Features & Use Cases

  • Scope understanding: analyze directories to propose a plan
  • Deduplication and archiving: identify duplicates and old files
  • Plan and execute: propose and perform structure changes with logging

Quick Start

Start with describing a target directory (e.g., Downloads or Documents) and request a plan; then execute moves according to approved plan.

Frequently Asked Questions about file-organizer

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

FAQPage Schema
How do I organize files in my Downloads folder automatically?

File organization automates the process by analyzing your Downloads directory, detecting duplicates using hash-based matching, proposing a logical folder structure by file type and purpose, then executing moves with your approval. It preserves timestamps, logs all actions, and enables rollback if needed.

Can this tool find and remove duplicate files across directories?

Yes. The Skill identifies duplicates through hash-based detection across Downloads, Documents, home directories, and project folders. It flags matching files, proposes removal or archival, and executes cleanup only after you confirm the plan.

What happens if file organization conflicts with existing folder structures?

The Skill handles conflicts robustly by proposing safe rename and move actions with detailed logging. You review and approve each change before execution, and full rollback capability is available if the reorganization doesn't meet your needs.

How do I archive old or stale files without manually sorting them?

Provide the target directory, and the Skill analyzes file age and structure to propose archival moves. You approve the plan, then it relocates stale items to designated archive folders with timestamped logs and safe conflict handling.

What file types and directories does this automation support?

File organization handles all file types across Downloads, Documents, home directories, and project folders. It categorizes by type and purpose, detects duplicates regardless of extension, and applies context-aware logic to propose appropriate folder hierarchies.

Can I undo file moves and folder changes after organization completes?

Yes. The Skill maintains detailed logs with timestamps for every action and includes rollback capability. If reorganization introduces problems, you can revert all moves and restores to the original state.