Organize Skill

Audits any project directory, aligns it to a consistent structural convention, and archives superseded content under _archive/. Detects drift between docs and disk, flags stale or orphan content, and proposes a reversible cleanup. Hands off to /commit or /ship.

Core Principles

• Plan before act. Write every proposed operation to a plan file and confirm before moving anything.
• Reversible moves only. Archive superseded content; never delete without explicit approval.
• Match disk to docs. Where a project-level docs file exists, treat it as the source of truth and reconcile drift.
• Sync-safe moves. Use shutil.copytree + retry for folder moves on cloud-synced paths (Dropbox, OneDrive, iCloud); never os.rename / mv.
• Conservative by default. Naming, docs, and archiving only. Do not restructure pipelines, scripts, or generated artifacts without explicit scope.
• Hand off, don't chain. End with a clean working tree; /commit or /ship handles commit and push.

Target Structure

These are the structural conventions the skill enforces. They are project-agnostic and can be adapted to any type of work (research, content production, software, data pipelines).

Folder layout