1181652815-hub/clean-windows-c-drive-skill / skills/clean-windows-c-drive
clean-windows-c-drive
VerifiedProvide a standalone Simplified Chinese Windows app and CLI workflows to assess C: drive health, clean a fixed allowlist of regenerable junk, find large user files, detect exact duplicates with SHA-256, and relocate or recycle explicitly approved ordinary user files without breaking Windows or installed applications. Use for the C: cleanup app, safe or deep cleanup, large-file or duplicate cleanup, health checks, space diagnosis, or moving ordinary files off C:. Always run the health gate and preview, protect system/personal/configuration data, keep one duplicate per group, and require explicit approval before changes.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 13.2 KB |
| agents/openai.yaml | config | 357 B |
| references/deep-clean-policy.md | markdown | 2.0 KB |
| references/health-policy.md | markdown | 2.1 KB |
| references/relocation-policy.md | markdown | 1.8 KB |
| references/safety-catalog.md | markdown | 2.8 KB |
| references/user-file-cleanup-policy.md | markdown | 1.2 KB |
| scripts/Find-CDriveDuplicateFiles.ps1 | script | 2.4 KB |
| scripts/Find-CDriveLargeFiles.ps1 | script | 1.1 KB |
| scripts/Get-CDriveCleanupReport.ps1 | script | 4.0 KB |
| scripts/Invoke-DeepCDriveCleanup.ps1 | script | 8.8 KB |
| scripts/Invoke-SafeCDriveCleanup.ps1 | script | 4.9 KB |
| scripts/Invoke-SafeFileRelocation.ps1 | script | 5.7 KB |
| scripts/Invoke-SafeUserFileCleanup.ps1 | script | 3.2 KB |
| scripts/New-SafeRelocationPlan.ps1 | script | 4.3 KB |
| scripts/Start-CDriveManager.ps1 | script | 23.4 KB |
| scripts/Test-CDriveHealth.ps1 | script | 7.5 KB |
| scripts/UserFileSafety.ps1 | script | 3.7 KB |
scripts/Invoke-SafeCDriveCleanup.ps1
View on GitHub[CmdletBinding()]
param(
[Parameter(Mandatory)]
[ValidateSet('Preview', 'Execute')]
[string]$Mode,
[string]$Category = 'UserTemp',
[string]$ConfirmPhrase = '',
[switch]$IncludeDetails
)
$ErrorActionPreference = 'Stop'
if ($Mode -eq 'Execute' -and $ConfirmPhrase -cne 'DELETE APPROVED ITEMS') {
throw 'Execution refused. Pass -ConfirmPhrase "DELETE APPROVED ITEMS" only after explicit user approval.'
}
$localAppData = [Environment]::GetFolderPath([Environment+SpecialFolder]::LocalApplicationData)
if ([string]::IsNullOrWhiteSpace($localAppData)) { throw 'Windows LocalApplicationData path is unavailable.' }
$categories = @($Category -split ',' | ForEach-Object { $_.Trim() } | Where-Object { $_ })
$allowedCategories = @('UserTemp', 'CrashDumps')
$invalidCategories = @($categories | Where-Object { $_ -notin $allowedCategories })
if ($categories.Count -eq 0 -or $invalidCategories.Count -gt 0) {
throw "Invalid category. Allowed values: $($allowedCategories -join ', ')."
}
$definitions = @{
UserTemp = [pscustomobject]@{
Root = Join-Path $localAppData 'Temp'
MinimumAgeDays = 7
Description = 'Current-user temporary files'
}
CrashDumps = [pscustomobject]@{
Root = Join-Path $localAppData 'CrashDumps'
MinimumAgeDays = 30
Description = 'Application crash dumps'
}
}
function Test-IsChildPath {
param([Parameter(Mandatory)][string]$Root, [Parameter(Mandatory)][string]$Candidate)
$rootFull = [IO.Path]::GetFullPath($Root).TrimEnd('\') + '\'
$candidateFull = [IO.Path]::GetFullPath($Candidate)
return $candidateFull.StartsWith($rootFull, [StringComparison]::OrdinalIgnoreCase)
}
$before = Get-CimInstance Win32_LogicalDisk -Filter "DeviceID='C:'"
$results = [System.Collections.Generic.List[object]]::new()
foreach ($categoryName in $categories | Select-Object -Unique) {
$definition = $definitions[$categoryName]
if ([string]::IsNullOrWhiteSpace($definition.Root)) {
$results.Add([pscustomobject]@{ Category = $categoryName; Status = 'Skipped'; Path = ''; Bytes = 0L; Reason = 'Environment path unavailable' })
continue
}
$root = [IO.Path]::GetFullPath([Environment]::ExpandEnvironmentVariables($definition.Root))
if (-not (Test-Path -LiteralPath $root -PathType Container)) {
$results.Add([pscustomobject]@{ Category = $categoryName; Status = 'Skipped'; Path = $root; Bytes = 0L; Reason = 'Directory does not exist' })
continue
}
$rootItem = Get-Item -LiteralPath $root -Force
if (($rootItem.Attributes -band [IO.FileAttributes]::ReparsePoint) -ne 0) {
$results.Add([pscustomobject]@{ Category = $categoryName; Status = 'Skipped'; Path = $root; Bytes = 0L; Reason = 'Root is a reparse point' })
continue
}
$cutoff = (Get-Date).AddDays(-1 * $definition.MinimumAgeDays)
Get-ChildItem -LiteralPath $root -File -Force -Recurse -ErrorAction SilentlyContinue -ErrorVariable scanErrors |
ForEach-Object {
$file = $_
$status = if ($Mode -eq 'Preview') { 'WouldDelete' } else { 'Deleted' }
$reason = ''
[long]$bytes = $file.Length
try {
if (-not (Test-IsChildPath -Root $root -Candidate $file.FullName)) { throw 'Resolved path escaped the approved root' }
if (($file.Attributes -band [IO.FileAttributes]::ReparsePoint) -ne 0) { throw 'Reparse point refused' }
if ($file.LastWriteTime -gt $cutoff) { return }
if ($Mode -eq 'Execute') { Remove-Item -LiteralPath $file.FullName -Force -ErrorAction Stop }
} catch {
$status = 'Skipped'
$reason = $_.Exception.Message
$bytes = 0L
}
$results.Add([pscustomobject]@{
Category = $categoryName; Status = $status; Path = $file.FullName
Bytes = $bytes; Reason = $reason
})
}
foreach ($scanError in @($scanErrors)) {
$results.Add([pscustomobject]@{ Category = $categoryName; Status = 'Skipped'; Path = $root; Bytes = 0L; Reason = $scanError.Exception.Message })
}
}
$after = Get-CimInstance Win32_LogicalDisk -Filter "DeviceID='C:'"
$eligible = @($results | Where-Object Status -in @('WouldDelete', 'Deleted'))
$skipped = @($results | Where-Object Status -eq 'Skipped')
[pscustomobject]@{
Mode = $Mode
Categories = @($categories | Select-Object -Unique)
EligibleFileCount = $eligible.Count
EligibleGiB = [math]::Round((($eligible | Measure-Object Bytes -Sum).Sum) / 1GB, 3)
SkippedCount = $skipped.Count
FreeGiBBefore = [math]::Round($before.FreeSpace / 1GB, 3)
FreeGiBAfter = [math]::Round($after.FreeSpace / 1GB, 3)
ActualFreeSpaceChangeGiB = [math]::Round(($after.FreeSpace - $before.FreeSpace) / 1GB, 3)
Details = if ($IncludeDetails) { @($results) } else { $null }
} | ConvertTo-Json -Depth 5
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |