file-organizer

Analyze filesystem directories, detect duplicates by hash, and reorganize files with user confirmation.

4|1|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/billlzzz26/visual-story-extension --skill file-organizer-billlzzz26
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-organizer
Source: https://github.com/billlzzz26/visual-story-extension/tree/main/.kilo/skills/file-organizer
Command: npx skills add https://github.com/billlzzz26/visual-story-extension --skill file-organizer-billlzzz26

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps users regain control of messy file systems by analyzing folder structures, finding duplicates, and proposing or performing safe cleanup and reorganization to reduce clutter and save space.

Core Features & Use Cases

  • Structure Analysis: Scans target directories to summarize file counts, types, sizes, and date ranges to reveal organization issues.
  • Duplicate Detection: Finds exact and likely duplicates by hash, name, and size, and presents clear recommendations for which copies to keep.
  • Smart Reorganization & Automation: Suggests logical folder hierarchies (by type, purpose, or date), moves and renames files with user approval, preserves metadata, and logs all changes.
  • Use Case: Clean a chaotic Downloads folder by sorting installers, documents, images, and archives into a proposed structure, resolving duplicates and archiving old project files.

Quick Start

Organize my Downloads folder by finding duplicates, proposing a clear folder hierarchy, and moving files only after I confirm each recommended change.

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 in my Downloads folder?

Duplicate file detection scans local directories like Downloads, comparing files by hash, name, and size to identify exact and likely duplicates. It presents clear recommendations on which copies to keep before any deletion occurs.

Can I automatically organize files and folders without losing my original timestamps?

Yes, you can automatically organize files and folders while preserving original metadata and timestamps. The system suggests a logical folder hierarchy and executes moves or renames only after you confirm each recommended change.

What is the best way to clean up a chaotic file system and save storage space?

Cleaning up a chaotic file system involves static analysis of file types and metadata to reveal organization issues, resolving duplicates, and archiving old project files. This reduces clutter and saves space through safe restructuring.

Does file organization work for photo libraries and project directories?

File organization works across local directories including Photos, Documents, Projects, and Downloads. It handles photo organization, archiving, renaming, and restructuring by applying logical hierarchies based on type, purpose, or date.

How do I restructure folders safely without accidentally losing important data?

Folder restructuring is performed safely by recommending a new hierarchy and moving files only with explicit user approval. All actions are logged, and original timestamps and metadata are preserved during the execution process.

What are the limitations of automated file cleanup for personal directories?

Automated file cleanup requires user confirmation for every move or rename action to prevent unintended data loss. It relies on static analysis of file types and metadata, meaning it does not dynamically interpret file content beyond hashing and naming conventions.