file-organizer

Analyze folder structures, detect duplicates, and reorganize files with user approval.

Updated Jan 7, 2026
One-click install
npx skills add https://github.com/jpolog/nix-os --skill file-organizer-jpolog
Or copy as Structured Prompt for Agentā–¼
Please help me install this Agent Skill.
Skill: file-organizer
Source: https://github.com/jpolog/nix-os/tree/main/pi-agent-data/agent/skills/file-organizer
Command: npx skills add https://github.com/jpolog/nix-os --skill file-organizer-jpolog

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill organizes your files and folders across your computer by understanding context, finds duplicates, suggests better structures, and automates cleanup tasks to reduce cognitive load and keep your workspace tidy.

Core Features & Use Cases

  • Intelligent analysis: Reviews your folders to understand content and context for smarter organization.
  • Duplicate detection and structure suggestion: Finds duplicates and proposes a cleaner, more logical folder layout.
  • Automated cleanup with safety: Moves and renames files according to the chosen structure, with your approval and a change log to undo if needed.
  • Real-world use case: Clean up a chaotic Downloads/Documents setup by sorting by type and archiving older files.

Quick Start

Ask me to analyze a target directory and automatically reorganize it by type, identify duplicates, and propose a structure you can approve.

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 folders on my computer by context?ā–¼

Automatically organize files by analyzing your target directory, understanding content context, identifying duplicates, proposing a new hierarchy, and executing file moves with your approval.

Can I find and remove duplicate files across my downloads and documents?ā–¼

Yes, you can find duplicates across downloads and documents by analyzing the target directory, which identifies redundant files and proposes a cleaner, more logical folder layout for your approval.

How does automated file cleanup handle safety and prevent data loss?ā–¼

Automated file cleanup executes moves and renames only with your explicit approval, storing a change log and preserving timestamps so you can undo actions if needed.

What is the best way to restructure a chaotic Downloads folder by file type?ā–¼

Restructure a chaotic Downloads folder by analyzing its current structure, proposing a new hierarchy sorted by type, identifying duplicates, and archiving older files after you approve the changes.

Can file organization be applied to personal laptops and work project directories?ā–¼

Yes, file organization applies to home desktops, personal laptops, and project directories, handling various content types including downloads, documents, media, and work projects.

Are file timestamps preserved when moving and renaming files during cleanup?ā–¼

Yes, file timestamps are preserved when executing file moves and renames, and a change log is stored to ensure you can safely undo the reorganization if necessary.