win11-storage-governance-kit README

The project's README from github.com/Nongfsq/win11-storage-governance-kit. As one markdown file: README.md.

Windows 11 Storage Governance Kit

中文文档 | English

A Codex Skills kit for fixing Windows 11 system-drive bloat.

This project turns a practical Windows 11 C-drive cleanup workflow into a reusable agent skill and reference runbook. The core idea is not simply to delete files. It is to govern the system drive: classify what is safe to clean, move large regenerable caches away from C:, configure package managers and developer tools to use stable non-system locations, and keep Windows-managed directories under official maintenance paths.

What Problem It Solves

Windows 11 machines often accumulate tens or hundreds of gigabytes under:

Most cleanup guides treat these as isolated junk folders. That is not enough. The same bloat returns unless the machine has a storage policy.

This kit provides that policy.

Core Principles

Repository Layout

.
├── docs/
│   ├── windows-11-c-drive-governance.md
│   ├── compatibility.md
│   ├── trigger-tuning.md
│   └── ...
├── examples/
│   ├── dry-runs.md
│   ├── usage-benchmark.md
│   └── replay-log-template.md
├── scripts/
│   ├── install.ps1
│   └── validate-pack.py
├── skills/
│   └── win11-storage-governance/
│       ├── SKILL.md
│       ├── agents/openai.yaml
│       └── references/
├── README.md
├── README.zh-CN.md
├── skill-pack.json
└── VERSION

The Skill

Skill name:

win11-storage-governance

Use it when the user asks about:

The skill is intentionally concise. Detailed logic lives in:

Install the Codex Skill

From the repository root:

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\install.ps1

Install to a custom skills root:

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\install.ps1 -DestinationRoot "C:\Users\<User>\.codex\skills"

Overwrite an existing installed copy:

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\install.ps1 -Force

Example Prompt

Use $win11-storage-governance to create a safe Windows 11 C-drive cleanup and storage migration plan for a developer workstation. Do not inspect the local machine.

For a local audit, be explicit:

Use $win11-storage-governance to inspect this Windows 11 machine and report what is safe to clean. Do not delete anything.

Validation

Validate the pack:

python .\scripts\validate-pack.py .

Validate the skill with Codex's system skill validator when available:

python C:\Users\<User>\.codex\skills\.system\skill-creator\scripts\quick_validate.py .\skills\win11-storage-governance

If your Python environment does not have PyYAML, run the validator through your preferred isolated tool runner, for example:

uvx --with pyyaml python C:\Users\<User>\.codex\skills\.system\skill-creator\scripts\quick_validate.py .\skills\win11-storage-governance

Safety Notice

This project is conservative by design. It will not recommend manual deletion of Windows servicing stores or installer caches. In particular:

For high-risk areas, use official tools, vendor uninstallers, repair utilities, quarantine workflows, and rollback plans.

License

MIT License.

win11-storage-governance-kit (Nongfsq/win11-storage-governance-kit)

Searching Database…

188 ·GitHub
Win11-storage-governance-kit
Что это?Набор Codex Skills, превращающий практический воркфлоу очистки диска C на Windows 11 в переиспользуемый агентский навык и справочный регламент для управления хранилищем (а не просто удаления файлов).
Это приложение, которое я запускаю, или навык, которому следует мой кодинг-агент?Это Codex Skill: упакованный набор инструкций и справочных документов (модель безопасности, регламент, шаблон профиля устройства), который Codex загружает и выполняет, а не программа, которую вы запускаете сами.
Это работает только с Codex или с любым кодинг-агентом?Он создан именно как Codex Skill, и набор можно проверить собственным системным валидатором навыков Codex; если в вашем Python нет PyYAML, валидатор запускается через изолированный раннер инструментов.
Удалит ли он за меня WinSxS или кэш Windows Installer?Нет, он отказывается это делать: он не посоветует вручную удалять C:\Windows\Installer или C:\Windows\WinSxS, не станет перемещать C:\Program Files\WindowsApps и не будет делать junction для всего AppData, профиля пользователя или ProgramData.
Он сканирует мои файлы и настройки автоматически?Нет. По умолчанию навык делает только планирование по шаблону и не проверяет ваши локальные папки, реестр, переменные окружения, логи или перечень пакетов, если вы явно его об этом не попросите.
Что именно он помогает перенести с диска C:?Он охватывает кэши winget, Scoop, npm, pip, NuGet, Rust, Playwright, Puppeteer, Hugging Face и Torch, плюс шейдерные кэши NVIDIA/DirectX, лаунчеры игр, ИИ-модели и SDK для разработчиков.
Какова ключевая философия набора в отношении очистки?Сначала наблюдать, потом удалять; классифицировать папки по риску; предпочитать официальные инструменты для системно управляемых хранилищ вроде WinSxS и Windows Update; переносить кэши, которые вырастут заново, а не просто удалять их один раз.
Можно ли использовать это для управления целым парком машин на Windows 11?Да, он задуман, чтобы помогать строить безопасный план очистки для одного устройства или парка похожих устройств, используя шаблон профиля устройства из репозитория.
Как проверяется пакет навыка?В репозитории есть валидатор набора, а проверить его можно и собственным системным валидатором навыков Codex, если доступен Python с PyYAML (или изолированный раннер инструментов).
What are similar projects?macos-sysdata, jev-browser-use, veet, no-negative-echo, PureMac, livecanvas, SwiftUI-Agent-Skill, disk-raccoon
Which topics is it in?cache-cleaner, maintenance, disk-usage, system-cleaner, cache, windows-11, codex-skill, storage, caching, package-manager, sysadmin, skill
Creator
Nongfsq
Size
<0.1 MB
Stars
188
Updated
CommitOct 09
Age
4mo
Commits · 90 Days