file-organizer

Organize local folders by analyzing structure, detecting duplicates, and moving files with user confirmation.

1|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/Thomashighbaugh/opencode --skill file-organizer-thomashighbaugh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-organizer
Source: https://github.com/Thomashighbaugh/opencode/tree/main/skills/file-organizer
Command: npx skills add https://github.com/Thomashighbaugh/opencode --skill file-organizer-thomashighbaugh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill reduces the cognitive load of a disorganized filesystem by analyzing folders, finding duplicates, proposing logical structures, and automating safe cleanup so users can quickly find and manage their files.

Core Features & Use Cases

  • Analyze current structure: Summarizes file counts, size distribution, file types, and date ranges to reveal organization issues.
  • Find duplicates: Detects identical or similarly named files and presents paths, sizes, and modification dates for informed decisions.
  • Suggest and apply organization: Proposes folder hierarchies by type, purpose, and date, then moves or renames files with user approval while preserving metadata.
  • Archive and cleanup: Identifies old or temporary files for archiving and helps safely remove or relocate clutter.
  • Use Case: Clean a chaotic Downloads folder, deduplicate Documents, restructure Projects into Active and Archive, or organize photos by year/month.

Quick Start

Help me organize my Downloads folder and propose a safe plan to move, rename, and archive files.

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 declutter a chaotic Downloads folder?

To automatically organize files, this Skill analyzes your Downloads directory to group items by type and date, detects duplicates using hashes, and proposes a safe structure to move and rename files with your confirmation.

What is the best way to find and remove duplicate files in my Documents?

Finding duplicate files is handled by detecting identical or similarly named items using file hashes and names, then presenting paths, sizes, and modification dates so you can make informed decisions for safe removal.

Can I restructure project directories into Active and Archive folders without losing metadata?

Yes, you can restructure project directories by proposing folder hierarchies categorized by type, purpose, and date, then executing safe move and rename operations while preserving metadata and maintaining an undo log.

How do I archive old files and clean up temporary items from my home directory?

Archiving old files and cleaning temporary items involves analyzing your home directory to identify outdated or temporary data, proposing relocation or removal strategies, and executing safe cleanup actions upon user approval.

Does file organization require manual confirmation before moving or renaming files?

File organization requires user confirmation before applying any structural changes, ensuring that proposed move and rename operations are reviewed and approved to prevent accidental data loss during directory cleanup.

What's the best way to organize photos by year and month across local directories?

Organizing photos by year and month is achieved through date-based grouping during directory analysis, allowing the Skill to propose a logical folder hierarchy that automatically categorizes your pictures chronologically.