file-organizer

Inventory directories, detect duplicate files by hash, and propose dry-run move plans.

24|8|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/vadimcomanescu/codex-skills --skill file-organizer-vadimcomanescu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-organizer
Source: https://github.com/vadimcomanescu/codex-skills/tree/main/skills/.experimental/devtools/file-organizer
Command: npx skills add https://github.com/vadimcomanescu/codex-skills --skill file-organizer-vadimcomanescu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Users often accumulate scattered files, duplicates, and inconsistent folder structures that make it hard to find important information and waste storage and attention; this Skill provides a structured, approval-first process to analyze, propose, and execute cleanups so users regain control of their digital workspace.

Core Features & Use Cases

  • Inventory & Analysis: Scan target directories to summarize file counts, types, sizes, and date ranges to reveal organization problems.
  • Duplicate Detection & Recommendations: Identify duplicates by hash or filename+size and recommend which copies to keep while always requiring confirmation before deletion.
  • Plan & Execute with Guardrails: Propose a dry-run move/rename plan, preserve modification dates, log changes for undo, and require explicit user approval prior to any destructive actions.
  • Use Case: Clean a messy Downloads folder by grouping files into Work, Personal, Installers, Archive, and ToSort, then move files only after user review.

Quick Start

Organize my Downloads folder, produce an inventory and a dry-run move plan listing duplicates and suggested target folders, and wait for my explicit approval before applying any changes.

Frequently Asked Questions about file-organizer

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

FAQPage Schema
How do I find and remove duplicate files on my computer?

To find duplicates, this Skill scans directories and computes file hashes or compares filename and size to accurately identify duplicate files, recommending which copies to keep while requiring explicit confirmation before deletion.

What is the safest way to clean up a messy Downloads folder?

The safest way to clean up a Downloads folder is using an approval-first workflow that produces an inventory, proposes a dry-run move plan to group files into categories, and executes changes only after explicit user approval.

Can I restructure project directories without losing my files?

Yes, you can restructure project directories safely because the Skill proposes a dry-run move and rename plan, preserves modification dates, logs all changes for potential undo, and requires explicit user approval prior to any destructive actions.

Does file organization work for preparing long-term archives?

Yes, file organization works for preparing archives by performing directory inventories that summarize file counts, types, sizes, and date ranges, ensuring consistent folder structures before you commit files to long-term archival storage.

What happens if a file cleanup plan makes a mistake during execution?

If a file cleanup plan makes a mistake during execution, the Skill mitigates this by preserving modification dates and logging all changes for undo, ensuring you can review the dry-run proposal and revert errors after the fact.

Do I need to approve every single file move during automated file cleanup?

No, you do not need to approve every single file move individually; the Skill generates a comprehensive dry-run move plan and requires your explicit approval once for the entire batch before applying any directory changes.