download-cleaner SKILL.md skillA

This file is byte-identical to the first copy the registry indexed. Same content hash, so the same checks give both the same grade.

download-cleaner from skyzhao1223/zspace-cli is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add skyzhao1223/zspace-cli/download-cleaner@git:20261009.88e9b2f

Pins git:20261009.88e9b2f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
skyzhao1223/zspace-cli
Path
skills/download-cleaner/SKILL.md
Versions recorded
4
Latest version
git:20261009.88e9b2f, committed Oct 9, 2026
First version recorded
Sep 20, 2026
Size
18,201 bytes
Repository stars
27
License
MIT

Use when 用户想清理 NAS 下载目录 — "下载区太乱帮我清一下"、"哪些下载可以删了"、"安装包/种子/压缩包占空间"、"下载完的视频没归档"、"半截下载残留"、"重复下载了好几次"。只读扫描按类别分诊(未完成/种子/安装包/压缩包/待归档媒体文档),给每文件一个建议动作(delete/extract/move-to-library/review);LLM 出清理计划,用户确认后由 Agent 执行。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Download Cleaner — 下载区分诊清理

## 概述

**跨 NAS 通用**:扫描脚本跑在**本地挂载路径**上(SMB/NFS),纯 stdlib 零依赖。

下载区是 NAS 最脏的地方:半截下载、用完的安装包、种子、解压后忘删的压缩包、
下载完没归档的影视/音乐/文档混在一起。本 skill 做**分诊**:给每个文件打类别 +
建议动作,不自动删。
**写操作不在脚本里** — LLM 按 `action` 分组出清理计划,用户确认后由 Agent 执行
(优先 `mv` 到隔离/归档目录,人工核对后再真删)。

## Prerequisites

```bash
open smb://<NAS_IP>/下载        # 极空间/群晖/威联通/绿联等均支持 SMB
python3 --version               # ≥3.9,无第三方依赖
```

## 快速验证

```bash
python3 download_cleaner.py scan --root /Volumes/nas/下载 --sample 500
```

## 命令

| 命令 | 用途 |
|------|------|
| `scan --root PATH` | 下载区分诊扫描(只读) |
| `scan --root PATH --json --output F` | JSON 输出 |
| `--stale-days N` | 超过 N 天视为久未处理(默认 365) |
| `--max-depth N` / `--sample N` / `--top N` | 深度 / 文件数上限 / 每类显示条数 |
| 同目录 `config.json` | 可选覆盖层:`skip_dirs` + `extension_overrides`(见下「配置覆盖」) |

## 配置覆盖(`config.json`,可选)

真实下载区里总有**故意的例外**:一个当仓库用的 `临时/` 目录、某款下载器的私有
半截文件扩展名、公司内部的 `.iso` 交付物。没有这个机制之前,唯一的办法是改脚本
里的 `SKIP_DIRS` / `*_EXTS` 集合 —— 而下次 `pip install -U` 就把它冲掉了。

**没有这个文件时,本 skill 的输出与引入该机制之前逐字节一致** —— 不多一个 JSON
字段、不少一条问题。

### 本 skill 接受哪些键

只有两个。**顶层出现第三个键 → 直接报错退出。**

| 键 | 类型 | 作用 |
|----|------|------|
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add skyzhao1223/zspace-cli/download-cleaner@sha256:4733a100d9d64c6b

The line at the top of this page pins the label git:20261009.88e9b2f, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ubxid4izkoacjxk2.svg)](https://markdownregistry.com/a/art_ubxid4izkoacjxk2)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Sep 20, 2026 and Oct 9, 2026, about one every 6 days.

versioncommittedcommitsizeaudit
git:20261009.88e9b2f latest2026-10-09 88e9b2f 18,201 BA view · diff
git:20261009.510d1ca2026-10-09 510d1ca 18,546 BA view · diff
git:20261008.aae65c72026-10-08 aae65c7 7,566 BA view · diff
git:20260920.d4bf53a2026-09-20 d4bf53a 7,055 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (18201 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

skyzhao1223/zspace-cli · 27 stars · license MIT · pushed 2026-10-09 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ubxid4izkoacjxk2
GET https://markdownregistry.com/api/v1/resolve?ref=skyzhao1223/zspace-cli/download-cleaner
GET https://markdownregistry.com/api/v1/blob/4733a100d9d64c6b070812242bc8317dda5f84ef5dbd73d692d39005dccc6726

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from skyzhao1223/zspace-cli

backup-auditor SKILL.md skill
skyzhao1223/zspace-cli · skills/backup-auditor/SKILL.md · Use when 用户想审计 NAS 上的备份 — "我的备份还新鲜吗"、"备份作业是不是挂了"、"哪些旧备份可以轮转删掉"、"关键目录都有备份吗"、"有没有孤儿备份/空备份"。只读审计:scan…
git:20261009.86c2bf8 · audit A · 27 stars
dedup-finder SKILL.md skill
skyzhao1223/zspace-cli · skills/dedup-finder/SKILL.md · Use when 用户想找 NAS 上的重复文件 — "哪些文件重复了"、"帮我找重复照片/视频/文档"、"磁盘被重复文件占满了"、"下载了好几次同一个东西"、"精确去重不要误删"。只读扫描用三级指纹(size → 头部64KB → 全量…
git:20261009.657293a · audit A · 27 stars
file-sorter SKILL.md skill
skyzhao1223/zspace-cli · skills/file-sorter/SKILL.md · Use when 用户想给 NAS 上一个「什么都往里丢」的乱目录做分类归档 — "帮我把文件分个类"、"图纸和文档混在一起"、"根目录一堆散文件"、"按类型建目录归档"、"dwg/pdf/图片全堆在一层"、"外置盘拷进来一堆东西没整理"。…
git:20261008.f01b099 · audit A · 27 stars
music-organizer SKILL.md skill
skyzhao1223/zspace-cli · skills/music-organizer/SKILL.md · Use when 用户想整理 NAS 上的音乐库 — "帮我整理音乐"、"歌曲散落一地"、"专辑没有封面"、"文件名带【FLAC】/320K 水印"、"曲目没有编号"、"路径和 ID3…
git:20261009.f321c25 · audit A · 27 stars
nas-report SKILL.md skill
skyzhao1223/zspace-cli · skills/nas-report/SKILL.md · Use when 用户想给 NAS 做整体存储体检 — "我 NAS 上都存了些啥"、"空间被什么占了"、"帮我做个存储报告"、"哪些数据该归档/清理"、"该用哪个整理…
git:20261008.f01b099 · audit A · 27 stars
photo-organizer SKILL.md skill
skyzhao1223/zspace-cli · skills/photo-organizer/SKILL.md · Use when 用户想整理 NAS/移动硬盘上的照片视频 — "帮我整理照片库"、"手机备份的照片太乱"、"截图和微信图片按日期归档"、"DCIM/IMG…
git:20261009.a9a41aa · audit A · 27 stars
portfolio-organizer SKILL.md skill
skyzhao1223/zspace-cli · skills/portfolio-organizer/SKILL.md · Use when 用户想整理 NAS 上的作品集 — "帮我整理作品集"、"设计项目文件太乱"、"源文件和成品混在一起"、"项目缺封面/说明"、"成品版本太多不知道哪个是最终版"、"大体积…
git:20261009.34b1347 · audit A · 27 stars
work-organizer SKILL.md skill
skyzhao1223/zspace-cli · skills/work-organizer/SKILL.md · Use when 用户想整理 NAS 上的工作文件 — "帮我整理工作目录"、"根目录一堆散文件"、"文档版本太乱(最终版/final/副本)"、"找临时文件和安装包"、"几年没动的文件归档"、"办公文档按项目/年份归位"。只读扫描(sca…
git:20261009.f321c25 · audit A · 27 stars
zspace-nas SKILL.md skill
skyzhao1223/zspace-cli · skills/zspace-nas/SKILL.md · Manage files on ZSpace (极空间) NAS through zspace-cli Python SDK and CLI. List, rename, move, copy, remove, search, and…
git:20261009.f7254dc · audit B · 27 stars
backup-auditor SKILL.md skill
skyzhao1223/zspace-cli · src/zspace_cli/skills/backup-auditor/SKILL.md · Use when 用户想审计 NAS 上的备份 — "我的备份还新鲜吗"、"备份作业是不是挂了"、"哪些旧备份可以轮转删掉"、"关键目录都有备份吗"、"有没有孤儿备份/空备份"。只读审计:scan…
git:20261009.86c2bf8 · audit A · 27 stars
dedup-finder SKILL.md skill
skyzhao1223/zspace-cli · src/zspace_cli/skills/dedup-finder/SKILL.md · Use when 用户想找 NAS 上的重复文件 — "哪些文件重复了"、"帮我找重复照片/视频/文档"、"磁盘被重复文件占满了"、"下载了好几次同一个东西"、"精确去重不要误删"。只读扫描用三级指纹(size → 头部64KB → 全量…
git:20261009.657293a · audit A · 27 stars
download-cleaner SKILL.md skill
skyzhao1223/zspace-cli · src/zspace_cli/skills/download-cleaner/SKILL.md · Use when 用户想清理 NAS 下载目录 — "下载区太乱帮我清一下"、"哪些下载可以删了"、"安装包/种子/压缩包占空间"、"下载完的视频没归档"、"半截下载残留"、"重复下载了好几次"。只读扫描按类别分诊(未完成/种子/安装包/压…
git:20261009.88e9b2f · audit A · 27 stars

Every file in skyzhao1223/zspace-cli

Other files named download-cleaner

download-cleaner SKILL.md skill
skyzhao1223/zspace-cli · src/zspace_cli/skills/download-cleaner/SKILL.md · Use when 用户想清理 NAS 下载目录 — "下载区太乱帮我清一下"、"哪些下载可以删了"、"安装包/种子/压缩包占空间"、"下载完的视频没归档"、"半截下载残留"、"重复下载了好几次"。只读扫描按类别分诊(未完成/种子/安装包/压…
git:20261009.88e9b2f · audit A · 27 stars

Browse by kind, by grade A, or by owner.