file-organizer

Analyze files and group them by content, metadata, and temporal patterns.

Updated Jan 18, 2026
One-click install
npx skills add https://github.com/mullzhang/skills --skill file-organizer-mullzhang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-organizer
Source: https://github.com/mullzhang/skills/tree/main/skills/mullzhang/file-organizer
Command: npx skills add https://github.com/mullzhang/skills --skill file-organizer-mullzhang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill tackles the common issue of cluttered digital workspaces by automatically organizing files based on their content, metadata, and temporal usage patterns.

Core Features & Use Cases

  • AI-Powered Analysis: Analyzes file names, content (where applicable), and metadata to understand relationships.
  • Temporal Clustering: Groups files that were likely worked on together based on modification times.
  • Smart Grouping: Proposes logical directory structures for user approval before execution.
  • Use Case: Clean up your messy Downloads folder by having the skill automatically group related project files, receipts, and media into distinct, organized subfolders.

Quick Start

Use the file-organizer skill to analyze and organize the files in your Downloads folder.

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

Automatically organize files by analyzing file names, content, and metadata to group related items into logical subfolders. The skill proposes a directory structure for your Downloads folder and executes the cleanup after user approval.

How does AI content analysis work for sorting desktop files?

AI content analysis for sorting desktop files works by examining file names, applicable content, and metadata to identify relationships. It also applies temporal clustering based on modification times to group files likely worked on together.

Can I group files by project automatically based on modification times?

Yes, you can group files by project automatically using temporal clustering. The skill analyzes modification times to group files that were likely worked on together, proposing a logical directory structure for your approval before moving them.

What is the best way to clean up messy directories without losing track of files?

The best way to clean up messy directories is using smart grouping that proposes a logical directory structure before execution. The skill analyzes content, metadata, and temporal patterns to group files, requiring your approval before any files are moved.

Does the file organization script require approval before moving files?

Yes, the file organization script requires approval before moving files. It analyzes your directory and proposes a logical directory structure based on content, metadata, and temporal patterns, executing the grouping only after you approve the proposed structure.

When should I not use automated file grouping for directory cleanup?

You should avoid automated file grouping when your directory contains files with no discernible metadata, content, or temporal relationships. The skill relies on analyzing file names, content, and modification times to propose logical subfolders, so unrelated files may not group effectively.