Folder Organizer

Folder Organizer

A skill for scanning, analyzing, and organizing files — producing a complete reorganization plan before touching anything.

Core Principle: Plan First, Execute Later

Never rename, move, copy, or delete any file before the user explicitly confirms the full plan.

Always present the complete plan and wait for an affirmative response.

Phase 1 — Scan & Inventory

Determine where the files are:

Run a scan and report:

# Count files and get basic stats
find <target_dir> -type f | wc -l
find <target_dir> -type f -name "*" | sort
ls -lah <target_dir>

Present a simple summary:

• 📁 Total file count
• File types found (extensions breakdown)
• Any immediately obvious duplicates or empty files

Phase 2 — Per-File Analysis

For each file, determine:

Filename conventions:

• Lowercase, use - or _ as separators
• Include context: 2024-q3-sales-report.xlsx not report.xlsx
• Keep extensions unchanged

Folder naming conventions:

• Short, noun-based: reports/, assets/, drafts/, archives/
• Avoid deep nesting beyond 2 levels unless necessary

Phase 3 — Grouping & Structure Proposal

After analyzing all files, produce:

1. Grouped clusters — files that belong together by topic, project, or type
2. Proposed folder tree — show as a tree diagram, e.g.:

   📁 organized/
   ├── 📁 reports/
   │   ├── 2024-q1-sales.xlsx
   │   └── 2024-q3-forecast.pdf
   ├── 📁 assets/
   │   ├── logo-primary.png
   │   └── banner-homepage.jpg
   └── 📁 drafts/
       └── proposal-v2.docx
   

3. Files to delete — list separately with reason
4. Files to bundle — groups that could be zipped together (e.g., all assets for a project)

Phase 4 — Confirmation Gate

Present the full plan and ask:

「以上是完整的整理計畫，請確認後我再執行。如需調整任何分類、檔名或資料夾名稱，請直接告訴我。」

(English: "Above is the complete reorganization plan. Please confirm before I proceed. Let me know if you'd like to adjust any category, filename, or folder name.")

Do not proceed until the user says yes / 確認 / 執行 or equivalent.

Phase 5 — Execution (only after confirmation)

Once confirmed, execute the plan:

# Example: create folders and move files
mkdir -p <output_dir>/reports
mv "<source>/old-name.xlsx" "<output_dir>/reports/2024-q3-sales.xlsx"
# ... etc

After execution:

• Show a final file tree of the result
• Confirm completion with file count moved/renamed

Edge Cases

Output Language

Match the user's language. If the user writes in Traditional Chinese (繁體中文), respond in Traditional Chinese. If in English, respond in English.