windows-file-organizer
13083940714lx-lgtm/windows-file-organizer
Windows filesystem cleanup skill for Claude Code - diagnose plan execute repair.
Instalação
npx convez-ai 13083940714lx-lgtm/windows-file-organizer1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
Windows File Organizer 🗂️
A systematic Windows filesystem cleanup skill for Claude Code — diagnose, plan, execute, and repair in four phases.
English
What is this?
Windows File Organizer is a Claude Code skill that helps you systematically clean up and organize your Windows filesystem. It follows a disciplined four-phase workflow: Diagnose → Plan → Execute → Repair, ensuring every file move is safe, reversible, and user-approved.
Features
| Phase | Description |
|---|---|
| 🔍 Diagnose | Scan disk usage, find large files, detect broken shortcuts, check registry, identify locked files — without touching anything |
| 📋 Plan | Generate a full action plan with risk labels (🟢 low / 🟡 medium / 🔴 high), source→target paths, and rollback steps |
| ⚡ Execute | Proceed from low-risk to high-risk: clean temp files, migrate user folders via registry, reorganize software & data, remove redundancies |
| 🔧 Repair | Fix broken shortcuts (.lnk), rebuild icon cache, verify all links, update desktop category folders |
Key Principles
- Diagnose first, never delete blind
- Plan before execute, always get user approval
- Low risk first, high risk last
- Never move installed software paths — move shortcuts instead
- Consolidate data into categorized directories (e.g.,
E:\Software\{category}\,E:\Data\{category}\) - Safe Mode for TrustedInstaller-locked files
Proactive Monitoring
The skill includes a startup scanner (scripts/startup-scan.ps1) that runs at every Claude Code session start. It checks:
- Desktop for loose files (non-shortcuts)
- Downloads folder for stale files (>1 day)
- C:\ root for large leftover files
- Documents folder (should be empty after migration)
If issues are found, Claude will proactively ask: "要我帮你整理吗?" (Want me to clean up?)
File Structure
windows-file-organizer/
├── SKILL.md # Main skill definition (Claude Code format)
├── REFERENCE.md # Command patterns, scripts, and examples
├── scripts/
│ └── startup-scan.ps1 # PowerShell startup scanner
└── README.md # This file
Installation
-
Copy this folder to your Claude Code skills directory:
%USERPROFILE%\.claude\skills\windows-file-organizer\ -
Restart Claude Code or reload skills — the skill auto-activates on trigger phrases.
Trigger Phrases
Say any of these in Claude Code to activate:
- "帮我整理一下电脑文件"
- "整理C盘"
- "清理桌面"
- "检查一下C盘"
- "把文件移到E盘"
- Any request involving Windows file organization
Requirements
- OS: Windows 10/11
- Shell: Git Bash (for
df,du,findcommands) - PowerShell: 5.1+ (for registry, shortcuts, process management)
- Claude Code: Latest version
License
MIT © 2025
中文
这是什么?
Windows File Organizer(Windows 文件整理器) 是一个 Claude Code 技能,帮助你系统性地清理和整理 Windows 文件系统。它遵循严格的四阶段工作流:诊断 → 规划 → 执行 → 修复,确保每次文件操作都是安全、可逆且经过用户确认的。
功能特性
| 阶段 | 描述 |
|---|---|
| 🔍 诊断 | 扫描磁盘使用情况、查找大文件、检测失效快捷方式、查询注册表、识别被锁定的文件 —— 不动任何文件 |
| 📋 规划 | 生成完整行动计划,标注风险等级(🟢 低 / 🟡 中 / 🔴 高),包含源路径→目标路径、回滚步骤 |
| ⚡ 执行 | 从低风险到高风险依次执行:清理临时文件、通过注册表迁移用户文件夹、重组软件与数据、删除冗余 |
| 🔧 修复 | 修复失效快捷方式(.lnk)、重建图标缓存、验证所有链接、更新桌面分类文件夹名称 |
核心原则
- 先诊断,不盲目删除
- 先规划再执行,必须获得用户确认
- 低风险优先,高风险靠后
- 绝不移动已安装软件的路径 —— 改成移动快捷方式
- 将数据归入分类目录(如
E:\Software\{类别}\、E:\Data\{类别}\) - 对于 TrustedInstaller 锁定的文件,使用安全模式处理
主动监控
技能内置了启动扫描器(scripts/startup-scan.ps1),在每次 Claude Code 会话启动时自动运行,检查:
- 桌面是否有散落文件(非快捷方式)
- Downloads 文件夹是否有超过 1 天的旧文件
- C:\ 根目录是否有残留大文件
- Documents 文件夹是否已清空(迁移后应为空)
发现问题时,Claude 会主动询问:"要我帮你整理吗?"
文件结构
windows-file-organizer/
├── SKILL.md # 技能主定义文件(Claude Code 格式)
├── REFERENCE.md # 命令模式、脚本与示例参考
├── scripts/
│ └── startup-scan.ps1 # PowerShell 启动扫描脚本
└── README.md # 本文件
安装方法
-
将此文件夹复制到 Claude Code 技能目录:
%USERPROFILE%\.claude\skills\windows-file-organizer\ -
重启 Claude Code 或重新加载技能 —— 技能会在触发语句出现时自动激活。
触发语句
在 Claude Code 中说以下任意一句即可激活:
- "帮我整理一下电脑文件"
- "整理C盘"
- "清理桌面"
- "检查一下C盘"
- "把文件移到E盘"
- 任何涉及 Windows 文件整理的需求
环境要求
- 操作系统: Windows 10/11
- Shell: Git Bash(用于
df、du、find命令) - PowerShell: 5.1+(用于注册表、快捷方式、进程管理)
- Claude Code: 最新版本
开源协议
MIT © 2025