Windows Disk Cleaner skill
A Windows skill that scans NTFS and ReFS drives fast through the MFT, with deletion left to you in a file tree window
- 90 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- The skill reads the whole file system and can mark files for deletion, while the erase decision stays with the user in the confirmation window.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/windows-disk-cleanerDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The skill reads the whole file system and can mark files for deletion, while the erase decision stays with the user in the confirmation window.
This is third-party code. Review the repository files before installing.
What it does
The skill analyses disk usage on Windows much like WizTree. The bundled `disk-cleaner.exe` CLI reads the MFT on NTFS directly and uses its own raw scanner for ReFS. Reports drill down by folder: the agent descends with `detail` and saves scan results to a `.dcscan` file. The agent never deletes files itself. The `rm` command only marks targets in `clean-targets.json`, and the final decision is yours in the `show-rm` window, where you tick and confirm each item. Before marking, the skill asks what should be cleaned and checks Git repositories for local commits, branches and untracked files.
Who it is for. Windows users with a full disk who want an agent to help free space while keeping the deletion decision in their own hands.
Good fit when
- The disk is nearly full and you need to see which folders take the most space
- Old repositories with build artifacts are checked for unpushed commits before cleaning
- Caches of specific applications and downloads are picked from a list and confirmed by hand
- You want a quick disk usage report without launching a separate program
Not a fit when
- You want fully automatic cleanup with no confirmation, which the skill does not offer
- The system is Linux or macOS, while the CLI targets Windows and the NTFS and ReFS file systems
- The disk is encrypted or mounted over the network, since strict scan modes need administrator rights and a local volume
Example request
Scan drive D, show the ten largest folders and suggest cleanup candidates, but mark nothing yetLimitations
Strict NTFS and ReFS scan modes need administrator rights and request elevation through UAC. The raw ReFS scanner is declared for version 3.14 only, and other versions use `--backend fs`. The skill instructions are written in Chinese. The README has no install commands: build the skill in Rust and install it with `scripts/install-skill.mjs`, or take a release.
How to disable. Delete the `windows-disk-cleaner` folder from the agent skills directory. Remove `.dcscan` files and `clean-targets.json` from working folders separately.
FAQ
How do I install the skill?
Clone the repository and run `node scripts/install-skill.mjs --release latest`, which installs the newest release into the skills directory. Plain `node scripts/install-skill.mjs` takes the local build from `dist/`.
Can the agent delete files without my consent?
No. The skill rules forbid the agent from deleting anything by any means. Deletion happens only in the `show-rm` window, where the user confirms each item.
Are administrator rights needed?
For strict NTFS and ReFS modes yes: with `--elevate` the CLI asks for UAC once. Without the flag such a mode fails with an error and does not fall back to a plain walk.
How does the skill treat Git repositories?
Before marking it checks local commits, branches, stash and untracked files. Age or a pushed HEAD alone is never treated as permission to delete.
Which file systems are supported?
NTFS through direct MFT reading and ReFS 3.14 through a raw scanner. Other cases use a plain walk with `--backend fs`.
Discussion
No questions or reviews yet.
Related
SkillsA Windows skill that analyzes drive C across 12 categories and builds a report and a staged cleanup plan.
A plugin that shows which skills, subagents and MCP servers waste context, then helps you remove the surplus
CLI that sorts a messy folder such as Downloads into places with natural-language rules, while an agent judges the files.
Sorting the Downloads folder on Yandex Disk: an agent skill
yandex-disk-downloads-sort-skill
A skill that sorts Downloads on Yandex Disk into categories, finds duplicates and keeps a move journal with undo
A Yandex Disk MCP server built for finding large files and cleaning up via the API, bypassing local sync
A Codex skill for safe local-state maintenance: a report-only default, backup and archive instead of deletion, log and worktree cleanup
README in short
The README is short: it states the purpose, stresses manual confirmation of deletion and shows interface screenshots. Detailed rules live in `SKILL.md` and `references/cli.md`.