| name | windows-powershell |
| description | Windows 11 system administration with PowerShell — system info reporting, hardware monitoring, package management (winget/scoop), disk cleanup, performance optimization, environment configuration, PowerShell profile setup with aliases and autocomplete, and Task Scheduler automation. Use when user asks to check system info, install tools on Windows, clean up disk space, set up PowerShell profile, or automate Windows tasks. Do NOT use for Linux administration, cross-platform scripting, or network infrastructure management. |
| license | MIT |
| compatibility | opencode |
| metadata | {"workflow":"operations","audience":"developers","version":"3.0","author":"shokunin"} |
| allowed-tools | Read Bash Write |
Windows PowerShell
Windows 11 system administration and automation with PowerShell 7.
Workflow
Step 1: System health check
scripts/system-info.ps1
Outputs:
- OS: Windows 11 build, edition, install date
- CPU: Model, cores, current usage %
- RAM: Total, used, free, usage %
- Disk: Per drive: total, used, free, usage %
- Top 5 processes by memory usage
- Network: Adapters, IP addresses
- Uptime: Days since last restart
- Windows Updates: Pending update count
If RAM usage > 80% or disk usage > 90%: proceed to Step 2.
Step 2: System cleanup
# Preview what would be cleaned
scripts/cleanup-system.ps1 -DryRun
# Clean everything
scripts/cleanup-system.ps1
Cleans:
- Windows temporary files
- Recycle Bin
- Windows Update cache
- npm/yarn/pnpm cache
- Docker unused data
- Windows.old (if present)
- Prefetch files
Reports total space recovered.
Step 3: Install development tools
# Install everything
scripts/install-tools.ps1
# Install specific categories only
scripts/install-tools.ps1 -Scope dev # Git, Node, Python, VS Code
scripts/install-tools.ps1 -Scope tools # 7-Zip, Windows Terminal, Oh My Posh
The script checks if each tool is already installed before attempting. Uses winget as primary, falls back to scoop.
Step 4: Set up PowerShell profile
Copy the premium profile template:
# Install the premium profile
Copy-Item "$env:USERPROFILE\.config\opencode\skills\windows-powershell\assets\Microsoft.PowerShell_profile.ps1" $PROFILE
# Reload profile
. $PROFILE
The profile includes:
- Oh My Posh prompt with git status
- PSReadLine with autocomplete and syntax highlighting
- Git aliases:
gst (status), ga (add), gc (commit), gp (push), gl (pull), gb (branch)
- npm aliases:
ni (install), nrd (run dev), nrb (run build), nt (test)
- Docker aliases:
dps (ps), dlog (logs), dstop (stop), drm (rm)
- Utils:
touch, which, ll (ls -la), mkcd (mkdir + cd), admin (runas admin)
Step 5: Schedule recurring maintenance
# Weekly cleanup every Sunday at 9 PM
schtasks /Create /SC WEEKLY /D SUN /TN "SystemCleanup" /TR "powershell.exe -File '$env:USERPROFILE\.config\opencode\skills\windows-powershell\scripts\cleanup-system.ps1'" /ST 21:00 /RL HIGHEST
Windows Utilities Reference
See references/powershell-mastery.md for complete reference.
| Task | Command |
|---|
| Find large files | `Get-ChildItem -Recurse |
| Kill process by port | `Get-Process -Id (Get-NetTCPConnection -LocalPort 3000).OwningProcess |
| Check disk health | `Get-PhysicalDisk |
| Export installed programs | `Get-WmiObject Win32_Product |
| Check battery health | powercfg /batteryreport |
| Network speed test | Invoke-WebRequest -Uri "http://speedtest.url" |
| Windows activation status | slmgr /xpr |
Error Handling
| Scenario | Cause | Fix |
|---|
winget not found | Outdated Windows or missing App Installer | Install from Microsoft Store or use scoop |
| Script execution blocked | PowerShell execution policy | Set-ExecutionPolicy RemoteSigned -Scope CurrentUser |
| Permission denied running script | Not admin for system operations | Run admin (from profile) or Start-Process powershell -Verb RunAs |
| Cleanup shows 0 bytes | No temp files to clean | That's fine. Run again in a week. |
| Tool installation fails | winget source out of date | winget source update |
Production Checklist
Anti-Patterns
| Anti-pattern | Fix |
|---|
| Installing tools manually every time | Use winget/scoop with install-tools script |
| Ignoring temp file buildup | Schedule weekly cleanup |
| Default PowerShell prompt | Customize with Oh My Posh |
| No aliases for common commands | Use the profile template |
| Running without admin when needed | Use admin alias for elevated commands |
Sources
- Microsoft PowerShell docs (learn.microsoft.com/powershell)
- Oh My Posh docs (ohmyposh.dev)
- PSReadLine docs (learn.microsoft.com)
- Windows Package Manager (winget) docs
- Scoop package manager (scoop.sh)
- SS64 PowerShell commands reference
