# File Organizer

> Organize, audit, rename, archive, or sync Jason Liu's Downloads and Desktop with a plan-first file cleanup workflow. Use for cleanup plans, plan-only file organizer runs, vague filename review, duplicate review, delete/trash candidates, moving durable documents into ~/Documents, mirroring important files to Google Drive, and writing cleanup logs under ~/Downloads/.cleanup_logs after explicit approval.

- Skill: `jxnl/file-organizer` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add jxnl/file-organizer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jxnl/file-organizer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: jxnl (https://skillmd.com/u/jxnl)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jxnl/file-organizer

---


# File Organizer

Use this skill when Jason asks to organize, clean up, audit, rename, archive, or sync files from `~/Downloads` or `~/Desktop`, especially when documents should move into `~/Documents` or be mirrored to Google Drive.

## Core Rule

Default to **plan first, apply second**.

1. Inventory `~/Downloads` and `~/Desktop`.
2. Ignore system clutter like `.DS_Store`, `.localized`, and hidden metadata unless it is inside a moved folder.
3. Classify files and top-level folders.
4. Inspect file contents only when names or locations are vague.
5. Propose moves, renames, Google Drive syncs, and deletion-review candidates.
6. Apply changes only after explicit confirmation.
7. Write a Markdown cleanup log under `~/Downloads/.cleanup_logs`.

## Source And Destination Roots

- Sources: `/Users/jasonliu/Downloads`, `/Users/jasonliu/Desktop`
- Local permanent home: `/Users/jasonliu/Documents`
- Cleanup logs and state: `/Users/jasonliu/Downloads/.cleanup_logs`
- Code/project review: `/Users/jasonliu/dev/_incoming_review`
- Google Drive: mirror only after a local Drive root is discovered or Jason provides one.

## Required Reference

Before creating a cleanup plan, read `references/organization-rules.md`. It defines naming conventions, folder taxonomy, Desktop rules, sync policy, duplicate handling, and safety constraints.

## Safety Constraints

- Do not delete files by default. Put delete/trash candidates in the plan.
- Do not overwrite existing files.
- Compare destination conflicts when possible; keep both different files with a descriptive suffix.
- Leave intentional Desktop aliases and symlinks in place unless broken or clearly stale.
- Keep personal wire and bank details in Finance bank folders, never inside investment deal folders.
- If Google Drive is missing, complete the local plan and ask for the Drive path before syncing.

## Output Format

For plan-only runs, return a concise cleanup plan with:

- Summary of source folders inspected.
- Proposed moves and renames.
- Proposed `~/Documents` destinations.
- Proposed Google Drive mirror actions or the reason sync is blocked.
- Duplicate/delete-review candidates.
- Assumptions and items needing Jason's decision.

For approved apply runs, report:

- Actions applied.
- Actions skipped and why.
- Cleanup log path.
- Any unresolved items.