smart-file-organizer

Analyze file contents to rename and reorganize files into logical folders.

4|1|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/surrealier/SmartFileOrganizer --skill smart-file-organizer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: smart-file-organizer
Source: https://github.com/surrealier/SmartFileOrganizer/tree/main
Command: npx skills add https://github.com/surrealier/SmartFileOrganizer --skill smart-file-organizer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Analyzes file contents to rename files to reflect what they contain, and optionally reorganizes them into a logical folder structure to reduce clutter and improve findability.

Core Features & Use Cases

  • Content-based renaming that recovers meaningful names from content rather than original file names.
  • Optional full-organize mode to create/rename/merge folders based on content categories with a safe rollback map.
  • Dataset-directory detection and handling, skipping or integrating as needed with user prompts.
  • Safe, interactive dry-run workflow that requires explicit approval and provides a rollback map for undo.
  • Collect mode to copy selected files into a targeted folder while preserving provenance.

Quick Start

Provide a target directory and mode, review the dry-run map, and approve the changes.

Frequently Asked Questions about smart-file-organizer

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

FAQPage Schema
How do I rename files based on their content instead of the original filename?

Content-based renaming analyzes what a file contains to generate a meaningful name. It reads content directly, handles language preferences and encoding corrections, and preserves the original file extension while avoiding dangerous changes.

Can I batch process and reorganize folders across a directory tree safely?

Yes, batch processing across directory trees supports a full-organize mode that creates, renames, or merges folders based on content categories. A safe, interactive dry-run workflow requires explicit approval and provides a rollback map for undoing changes.

What is the best way to recover meaningful file names from disorganized directories?

Recovering meaningful names involves reading file content to determine what it contains. This approach reduces clutter and improves findability by replacing unhelpful original filenames with descriptive ones derived from the actual data.

Does the file organization workflow handle dataset directories?

Yes, dataset-directory detection is supported during processing and handling. It automatically identifies these structures, skipping or integrating them as needed with user prompts to ensure they are not disrupted.

How do I collect selected files into a targeted folder while tracking where they came from?

Collect mode copies selected files into a targeted folder while preserving provenance. This ensures you know exactly where each file originated, maintaining traceability during folder reorganization.

What happens if a batch rename or folder reorganization goes wrong?

If a batch rename or reorganization goes wrong, a rollback map records all modifications. This safe rollback workflow allows you to undo folder merges and filename changes, reverting the directory tree to its original state.