system-health

Report desktop and SwarmAI runtime health with memory, CPU, disk, and process metrics.

36|4|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/xg-gh-25/SwarmAI --skill system-health-xg-gh-25
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: system-health
Source: https://github.com/xg-gh-25/SwarmAI/tree/main/backend/skills/s_system-health
Command: npx skills add https://github.com/xg-gh-25/SwarmAI --skill system-health-xg-gh-25

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

SwarmAI's system-health skill consolidates desktop and runtime metrics into a single, readable health report, enabling rapid visibility into resource consumption and performance bottlenecks.

Core Features & Use Cases

  • Desktop Overview with RAM, CPU, Disk, and Battery status, surfacing at-a-glance health.
  • Worst Offenders: top memory and CPU processes to guide optimization.
  • SwarmAI Resource Details: Backend, sessions, MCPs, and memory footprint across components.
  • Swarm Job System health when installed, plus actionable recommendations.
  • System Verdict and practical suggestions to reclaim headroom during development.

Quick Start

Invoke the system-health skill during a debugging session to generate a complete health report for the workstation and SwarmAI runtime.

Frequently Asked Questions about system-health

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a system health report for macOS to check CPU and memory usage?▼

You can monitor CPU and memory usage by running a system health diagnostic that leverages psutil to collect runtime metrics, identifying top process offenders and summarizing the data into a four-section markdown report for troubleshooting.

What is the best way to identify memory and CPU bottlenecks during runtime troubleshooting?▼

The best way to identify memory and CPU bottlenecks is to surface top process-level offenders using a performance monitoring diagnostic, which aggregates system metrics and delivers a verdict with practical suggestions to reclaim resource headroom.

Does psutil work for diagnosing desktop performance issues on Linux environments?▼

Yes, psutil works for diagnosing desktop performance issues on Linux environments by gathering system metrics in a sandboxed backend, enabling the generation of a comprehensive health report covering RAM, CPU, disk usage, and process offenders.

How do I check SwarmAI runtime health and resource consumption?▼

You can check SwarmAI runtime health by invoking a system-health diagnostic that aggregates backend sessions, MCPs, and memory footprints, generating a structured report that includes Swarm job system health and optimization recommendations.

What are the limitations of using psutil for system performance monitoring in a sandboxed backend?▼

While psutil effectively gathers system metrics in a sandboxed backend for performance monitoring, its limitations involve potential restrictions on accessing deeper kernel-level diagnostics or specific hardware metrics outside the standard CPU, memory, and disk usage scope.