file-organizer

Organize macOS downloads into categorized folders with whitelist protection.

27|6|Updated Jan 24, 2026

Search Tags:#automation #documents #macos #whitelist #downloads #file-organizer #smart-folders

Ready to run

npx skills add https://github.com/crazynomad/skills --skill file-organizer-crazynomad

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: file-organizer
Source: https://github.com/crazynomad/skills/tree/main/file-organizer
Command: npx skills add https://github.com/crazynomad/skills --skill file-organizer-crazynomad

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Mac users often accumulate clutter in the Downloads folder, risking loss of important files when folders are moved or code files are accidentally touched.

Core Features & Use Cases

Organize downloads by category (documents, presentations, PDFs, images, etc.) into clearly named folders.
Protect code and configuration folders with a whitelist to prevent accidental movements.
Generate smart folders for previewing matches before actions, and support manual or automatic workflow.

Quick Start

Organize your Downloads by guiding the agent to classify and move files into structured folders while shielding code 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 my Mac Downloads folder by file category?▼

To automatically organize Mac Downloads, this Skill scans the directory, maps files into categories like documents and images, and safely moves them into structured folders. It supports both manual and automatic workflows for clutter-free file management.

How does whitelist protection prevent accidental file moves on macOS?▼

Whitelist protection shields code and configuration folders from accidental moves during the file organization process. It identifies important files and excludes them from safe-move operations, ensuring critical macOS documents remain untouched.

Can I preview file matches before moving documents into smart folders?▼

Yes, you can preview file matches before moving documents by generating smart folders. This non-destructive feature scans your chosen scope and displays categorized results, allowing you to verify the mapping before any files are actually moved.

What is the best way to sort downloaded files without deleting important code?▼

The best way to sort downloaded files without losing code is using a non-destructive organizer with whitelist protection. This Skill categorizes documents, presentations, and images while explicitly shielding code files from being touched or moved.

Does this file organizer support scanning the macOS Documents folder?▼

Yes, this file organizer supports scanning the macOS Documents folder. You can configure the scanning scope to apply across Downloads, Documents, or home scopes, with category mapping and conflict handling applied safely.

What happens when file naming conflicts occur during the sorting process?▼

When file naming conflicts occur during the sorting process, the Skill applies conflict handling to ensure non-destructive behavior. It safely resolves duplicate names during the safe-move operations to prevent overwriting existing files.