storage-analyzer

In the commands below, `<skill-dir>` is this skill's base directory, announced when the skill loads. Substitute the literal path. On Windows, `py -3` may replace `python`. Default: scan and write a static HTML report. Do not start `server.py` until the user approves the shown absolute paths in this turn. ## Routing - Disk full, C: drive, storage analysis, cache cleanup: this skill. - RAM / which process uses memory: refuse. - Windows dev-process leftover trees: `windows-dev-process-cleanup`. - Downloads categorize/rename: `file-sorter`. - Startup apps: refuse; this skill does not disable startup items. - Linux hosts: refuse. `scan.py` exits 2 with `unsupported_platform`. ## Workflow 1. Scan (read-only). `--output` must be an absolute path. Do not capture JSON with PowerShell `>`. ```text python "<skill-dir>/scripts/scan.py" --output <abs-scan.json> ``` Windows default groups: AppData Local/Roaming, Temp, Downloads, existing dev cache roots. Do not pass `--include-system-apps` unless the user asked to size Program Files. 2. Read [classification.md](references/classification.md) and the OS file: [windows.md](references/windows.md) or [macos.md](references/macos.md). Write `analysis.json` with `top5`, `green`, `yellow`, `red`, `summary`. Green `trash_paths` must sit under [cache-prefixes.json](references/cache-prefixes.json). 3. Build the static report: ```text python "<skill-dir>/scripts/build_report.py" <abs-analysis.json> --output <abs-report.html> ``` Open the HTML for the user. Summarize estimated reclaim, the first two actions, and the highest-risk item. 4. After this-turn approval of the exact trash/open paths, start the local server in the background and give the user `REPORT_URL`: ```text python "<skill-dir>/scripts/server.py" <abs-analysis.json> --no-browser ``` The server accepts `trash` and `open` only. `rm` is disabled. Green trash still has to match the prefix table. Stop the server when the user is done. Do not call `rm`, `Remove-Item`, or `SHFileOperation` on user paths. Trash goes only through `server.py`. ## Output Report scan path, report path, denied directories, and whether the session stayed on the static report. Mark real Recycle Bin execution, isolated install, provider comparison, and human blind review as `missing evidence`. ## Resources - [scan-safety.md](references/scan-safety.md) - [classification.md](references/classification.md) - [report-schema.md](references/report-schema.md) - [cache-prefixes.json](references/cache-prefixes.json) - [windows.md](references/windows.md) - [macos.md](references/macos.md)