file-organizer

Scan and organize files by type and content into designated folders.

15|3|Updated Jul 8, 2026
One-click install
npx skills add https://github.com/moonlight-lupin/agent-skills --skill file-organizer-moonlight-lupin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-organizer
Source: https://github.com/moonlight-lupin/agent-skills/tree/main/productivity/file-organizer
Command: npx skills add https://github.com/moonlight-lupin/agent-skills --skill file-organizer-moonlight-lupin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires stdlib, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill solves the issue of cluttered directories and inefficient file management, automating the process of scanning, categorizing, renaming, and organizing files on various file systems.

Core Features & Use Cases

  • Automated Scanning and Organization: Scan and organize files by type and content into designated folders, including a renaming option for file metadata and snippets.
  • User Confirmation Gate: Ensures all file changes are approved by the user, eliminating unintended overwrites or deletions.
  • Chunked Execution: Moves files in batches to handle errors and allow manual review after each step.
  • Cross-Filesystem Support: Operates on local, networked, and remote filesystems.
  • Use Case: Use the File Organizer skill to quickly categorize your Documents folder based on content type, saving you time and effort.

Quick Start

Run the following command to begin the file organization process:

python3 scripts/organize.py scan --path /path/to/directory

Frequently Asked Questions about file-organizer

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

FAQPage Schema
How do I automate directory cleanup and file categorization for cluttered folders?

Automate directory cleanup by scanning files, reasoning over metadata, proposing organizational structures, and moving files after user confirmation. This process categorizes files by type and content into designated folders to streamline file management.

How does LLM-powered file organization work for categorizing files?

LLM-powered file organization works by scanning your directories, analyzing file metadata and snippets, and proposing a structured categorization. It suggests folder structures and renaming options based on content, requiring your confirmation before moving any files.

Can I use filesystem automation to organize files on remote and networked paths?

Yes, you can use filesystem automation to organize files on remote and networked paths. The skill handles local, networked, and remote filesystems, requiring appropriate file system access and permissions for modification.

What is the best way to safely organize files without unintended deletions or overwrites?

The best way to safely organize files is using a user confirmation gate that requires approval for all changes. The system moves files in chunked batches, allowing manual review after each step to eliminate unintended overwrites or deletions.

How do I handle file organization for large directories efficiently?

Handle file organization for large directories by using optional cheaper LLM services to optimize repetitive tasks. The skill scans and processes files in batches, proposing structures and executing moves efficiently while managing errors through chunked execution.

Do I need special permissions to run scripts for automated file organization?

Yes, you need file system access and modification permissions to run scripts for automated file organization. The script scans your specified directory path, proposes changes, and executes file moves only after you grant explicit user confirmation.