cvm-ai-doctor

Diagnose system performance and health issues across Linux, macOS, and Windows using tiered quick-scan and deep-analysis workflows.

Updated Aug 7, 2026
One-click install
npx skills add https://github.com/Protremix/EvolvixOS --skill cvm-ai-doctor-protremix
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cvm-ai-doctor
Source: https://github.com/Protremix/EvolvixOS/tree/main/knowledge/experts/cvm-ai-doctor/skills/cvm-ai-doctor
Command: npx skills add https://github.com/Protremix/EvolvixOS --skill cvm-ai-doctor-protremix

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Diagnosing slow servers, high CPU, memory exhaustion, disk failures, and system errors normally requires deep sysadmin expertise and manual command-line investigation. This Skill gives an AI agent a structured diagnostic knowledge base so it can triage problems in seconds and perform root-cause analysis with safe, user-confirmed remediation. ## Core Features & Use Cases - Quick/Deep Two-Phase Diagnosis: Runs a ~3-second quick scan script (bash or PowerShell) returning OK/WARNING/CRITICAL per component, then triggers targeted deep-analysis modules only for flagged components. - Tiered Scenario Routing: Matches user keywords against 10 built-in core scenarios covering 80% of issues, falling back to a 60+ scenario index spanning 20 categories and 126 command files. - Risk-Gated Remediation: Classifies fixes into low/medium/high risk levels, requiring explicit user confirmation before service restarts, config changes, or package operations. - Cluster Management: Integrates with a Tencent Cloud infrastructure skill for multi-node CVM health checks, scoring, deep analysis, and gated remediation. - Use Case: A user says "my server is slow" — the agent runs the quick scan, finds memory at WARNING, runs the memory deep-analysis module, identifies a Java process leaking 8GB, and proposes a confirmed restart plus JVM tuning. ## Quick Start Ask the agent to run a full system health check on this machine and explain any warnings it finds.

Frequently Asked Questions about cvm-ai-doctor

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

FAQPage Schema
How do I diagnose why my Linux server is slow?▼

Run the quick scan script to get OK/WARNING/CRITICAL status for CPU, memory, disk, and network in about 3 seconds. Any flagged component then triggers a targeted deep-analysis module that identifies root causes such as memory leaks or I/O saturation.

How to check disk health with SMART on Linux, macOS, and Windows?▼

Use the disk SMART quick module, which runs smartctl-based checks per platform and returns a health verdict. If the result is FAILED, the deep module analyzes attributes like reallocated sector counts to assess failure risk.

Does this system diagnostic skill work on Windows?▼

Yes, it ships a PowerShell quick scan script (quick_scan.ps1) covering CPU queue, memory, disk queue, and network drops in about 5 seconds. Command files include Windows-specific columns alongside Linux and macOS commands.

Can it diagnose multiple servers or a CVM cluster at once?▼

Yes, cluster scenarios integrate with a Tencent Cloud infrastructure skill to run DescribeInstances, cloud monitoring metrics, and TAT remote commands across nodes. It produces per-node health scores and supports gated remediation like reboots.

Will the diagnostic commands change my system without permission?▼

No. All diagnostic commands are read-only, and any state-changing action is classified by risk level. Medium-risk actions like service restarts require confirmation, and high-risk actions like config changes require explicit approval with impact warnings.

What are the limitations of the quick scan approach?▼

The quick scan only reports component-level status and cannot identify root causes by itself. Deep analysis adds 20-60 seconds per component, and some advanced modules like BTRFS snapshots and PipeWire tuning are Linux-only.