From ai-agent-skills
Health sweep across a fleet of Windows POS machines (Dynamics AX 2012 R3 Retail POS or similar) — or any Windows server/workstation fleet — over PowerShell Remoting. The bundled script checks each machine in parallel for stopped auto-start services (POS/Retail/SQL by default), local SQL Server instances with per-database sizes (flagging databases approaching the SQL Server Express 10 GB limit), low disk space, and recent Critical/Error event counts, returning ranked warnings as JSON. Use when the user wants to check/sweep/inspect the POS fleet or a set of Windows machines — e.g. "check all the POS machines", "which tills have problems", "is any POS offline database near the Express limit", "sweep the store machines for stopped services". Read-only. Requires PowerShell 7+, WinRM on the targets, and an admin credential (always prompted).
How this skill is triggered — by the user, by Claude, or both
Slash command
/ai-agent-skills:retail-pos-fleet-healthThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
> Sweeps **many Windows machines in parallel** over WinRM. The bundled script
Sweeps many Windows machines in parallel over WinRM. The bundled script
scripts/Invoke-PosFleetHealth.ps1collects health signals and emits JSON with deterministically ranked warnings; the agent (you) writes the narrative. The script is read-only on the targets — it never starts/stops anything.
SCRIPT = this skill's scripts/Invoke-PosFleetHealth.ps1.
The script always prompts for an admin credential (Get-Credential) — held in memory
for the run, reused across all hosts, never written to disk. Do not pass passwords on the
command line. SQL checks run inside each remote session against localhost with that
Windows login — no SQL credentials needed.
Always run with pwsh. Parse the JSON from stdout.
| Want | Pass |
|---|---|
| A few machines | -ComputerName POS001,POS002,POS003 |
| The whole fleet | -ServerListFile C:\ops\pos-hosts.txt (one host per line, # comments OK) |
| Other services | -ServicePattern '*POS*','*Retail*','MSSQL*','MyService*' |
| Stricter disk check | -DiskMinFreePct 15 |
| Event window | -EventHours 24 (default) |
| Express limit warn level | -ExpressWarnAtPct 80 (default; of -ExpressLimitGB 10) |
| Parallelism | -ThrottleLimit 12 (default) |
| Save full report | -OutFile C:\ops\fleet-health.json (do this for 100 hosts!) |
| Transport/auth | -UseSSL · `-Authentication Negotiate |
# Full fleet sweep, detail to file, compact summary on stdout
pwsh -File SCRIPT -ServerListFile C:\ops\pos-hosts.txt -OutFile C:\ops\fleet-health.json
-OutFile → full JSON (all hosts) on stdout.-OutFile → full detail to the file; stdout gets a compact summary
(status, host counts, ranked warnings). For big fleets always use -OutFile.summary.warnings is ranked: unreachable/auth → stopped services → Express DBs near the
limit → low disk → SQL query failures → high error counts. Each warning has
computer, type, detail. Per-host detail (disks, services, SQL instances + database
sizes, recent error counts) is under hosts[]. See REFERENCE.md.
summary.warnings — grouped by type, named by machine. A fleet sweep
answer is "which machines need attention and why", not 100 host reports.hosts_failed (unreachable/auth) explicitly —
an unreachable POS may itself be the incident. Never imply full coverage when hosts
failed.unreachable hosts → WinRM not enabled on POS images, firewall, or wrong network.auth_failed → the credential lacks admin rights on the targets.sql_query_failed on a host → SQL service running but the login has no access; the rest
of the host's data is still collected.npx claudepluginhub whobat/ai-agent-skills --plugin ai-agent-skillsProvides CDSS development patterns for drug interaction checking, dose validation, clinical scoring (NEWS2, qSOFA), and alert classification integrated into EMR workflows.