file-organizer

Analyze directory structures, detect duplicates, and automate file organization with approval.

5|2|Updated Dec 11, 2025
One-click install
npx skills add https://github.com/thoreinstein/opencode-config --skill file-organizer-thoreinstein
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-organizer
Source: https://github.com/thoreinstein/opencode-config/tree/main/skill/file-organizer
Command: npx skills add https://github.com/thoreinstein/opencode-config --skill file-organizer-thoreinstein

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill tackles the challenge of scattered files and messy folders by analyzing your current structure, identifying duplicates, and proposing a clean, logical organization plan with automated cleanup actions (with your approval).

Core Features & Use Cases

  • Analyze current directory structures to understand your files and folders.
  • Detect duplicates and suggest which copies to remove or consolidate.
  • Propose a scalable, user-friendly folder structure and automate cleanup tasks that preserve important data.
  • Use cases include tidying the Downloads folder, reorganizing project workspaces, and preparing data for archiving.

Quick Start

Organize my Downloads folder by creating a Work/Personal/Archive structure and moving files accordingly.

Frequently Asked Questions about file-organizer

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

FAQPage Schema
How do I organize my Downloads folder and reduce file clutter automatically?

To organize your Downloads folder and reduce file clutter automatically, this Skill analyzes your current directory structure, identifies duplicates, and proposes a logical organization plan. It then moves, renames, and archives files with your approval.

What is the best way to find and remove duplicate files in a messy directory?

The best way to find and remove duplicate files in a messy directory is to use an automated analysis tool that detects matching copies. This Skill identifies duplicates and suggests which copies to consolidate or remove while preserving data.

Can I automate file cleanup for project folders without losing important data?

Yes, you can automate file cleanup for project folders without losing important data. The Skill proposes a scalable folder structure and executes cleanup tasks locally, ensuring data is preserved while moving and archiving files only as directed.

Does this file organizer require any scripts or dependencies to run?

No, this file organizer does not require any external dependencies. It satisfies deterministic file operations through local commands and optional scripts, requiring no prior environment setup to analyze state and suggest structures.

When should I use an automated file structure tool instead of manual sorting?

You should use an automated file structure tool instead of manual sorting when dealing with messy home directories, large archives, or scattered Downloads folders. It analyzes context and suggests scalable structures faster than manual sorting.

What are the limitations of automated file organization for archives?

A limitation of automated file organization is that it requires your explicit approval before moving, renaming, or archiving files. While it suggests structures and detects duplicates, it relies on user direction to preserve important data safely.