alibabacloud-ecs-troubleshoot-skills
Troubleshooting skills for Alibaba Cloud ECS
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
Its scripts were only partly scanned.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/aliyun/alibabacloud-ecs-troubleshoot-skills with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/aliyun/alibabacloud-ecs-troubleshoot-skills'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/aliyun--alibabacloud-ecs-troubleshoot-skills)HTML
<a href="/listings/aliyun--alibabacloud-ecs-troubleshoot-skills"><img src="/api/listings/aliyun--alibabacloud-ecs-troubleshoot-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Install all Skills globally with [skills.sh](https://skills.sh):
npx skills add aliyun/alibabacloud-ecs-troubleshoot-skills -g
Alternatively, install them manually:
git clone https://github.com/aliyun/alibabacloud-ecs-troubleshoot-skills.git mkdir -p ~/.agents/skills cp -r alibabacloud-ecs-troubleshoot-skills/skills/* ~/.agents/skills/
For cloud-based OS troubleshooting, configure aliyun CLI and its plugins:
aliyun configure aliyun plugin install --names aliyun-cli-ecs # Optional: required only when the Linux Skill queries CloudMonitor metrics aliyun plugin install --names aliyun-cli-cms
Windows troubleshooting performed directly inside the GuestOS does not require aliyun CLI.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 140 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # Alibaba Cloud ECS Troubleshooting Skills
- [English](README.md) | [简体中文](README.zh-CN.md)
- A collection of Agent Skills for structured, reproducible troubleshooting and security assessment of Alibaba Cloud ECS instances.
- ## Overview
- This repository provides four self-contained Skills that AI agents can load to diagnose Linux and Windows operating-system issues, investigate Linux userspace compromises, and assess Linux kernel vulnerabilities.
- Each Skill uses its own `SKILL.md` as the entry point. The file defines when the Skill applies, how the agent should work, which dependencies it needs, and where to find detailed references.
- ## Choose a Skill
- | Need | Skill | Primary scope |
- | --- | --- | --- |
- | Diagnose an ECS Linux OS issue | [`alibabacloud-ecs-linux-os-troubleshooting`](skills/alibabacloud-ecs-linux-os-troubleshooting/SKILL.md) | Boot, access, network, disk/filesystem, performance, crash/hang, clock, and configuration issues |
- | Diagnose or repair an ECS Windows issue | [`alibabacloud-ecs-windows-os-troubleshooting`](skills/alibabacloud-ecs-windows-os-troubleshooting/SKILL.md) | Online or offline Windows diagnosis through local PowerShell or Cloud Assistant |
- | Investigate a suspected Linux userspace compromise | [`alibabacloud-ecs-sec-userspace`](skills/alibabacloud-ecs-sec-userspace/SKILL.md) | Intrusion detection, evidence collection, and attack-chain analysis |
- | Assess Linux kernel CVEs | [`alibabacloud-ecs-sec-kernel`](skills/alibabacloud-ecs-sec-kernel/SKILL.md) | Kernel CVE detection and controlled PoC validation |
- ## Skill Capabilities
- ### Linux OS Troubleshooting
- `alibabacloud-ecs-linux-os-troubleshooting` follows a seven-stage workflow: select execution mode, complete environment information, classify the phenomenon domain, check the GuestOS boundary, use diagnostic capabilities, investigate components, and summarize evidence and recommendations.
- It covers instances stuck during startup, SSH/VNC/Workbench access failures, network loss or latency, disk and filesystem issues, performance anomalies, suspected mining or hidden processes, crashes or hangs, clock drift, and configuration changes that do not take effect. Cloud API calls prefer local aliyun CLI and can fall back per capability to an already configured Alibaba Cloud OpenAPI MCP Server.
- See the [complete Linux troubleshooting workflow](skills/alibabacloud-ecs-linux-os-troubleshooting/SKILL.md).
- ### Windows OS Troubleshooting
- `alibabacloud-ecs-windows-os-troubleshooting` supports both online diagnosis of a running Windows system and offline diagnosis when a faulty system disk is attached to a helper instance. It can run directly inside the GuestOS with PowerShell or remotely through Cloud Assistant.
- Its problem domains include boot failures, crashes or hangs, RDP/VNC access, network and external-port reachability, storage, activation, Windows Update, time synchronization, accounts and permissions, BitLocker, drivers, application failures, certificates and TLS, scheduled tasks, performance, and management channels.
- See the [complete Windows troubleshooting workflow](skills/alibabacloud-ecs-windows-os-troubleshooting/SKILL.md).
- ### Userspace Security Detection
- `alibabacloud-ecs-sec-userspace` provides Linux userspace intrusion detection and forensics with 51 security analyzers and 10 data collectors. It covers 12 detection categories and maps findings to 103+ MITRE ATT&CK techniques.
- It supports standalone, Docker, and Kubernetes modes and produces Markdown reports, JSON evidence, attack-chain analysis, and execution logs. Use it together with the kernel security Skill when both userspace compromise and kernel exposure need assessment.
- See the [complete userspace security workflow](skills/alibabacloud-ecs-sec-userspace/SKILL.md).
- ### Kernel CVE Detection
- `alibabacloud-ecs-sec-kernel` provides 88 Linux kernel CVE detectors spanning 2003–2026. It supports source-based dynamic PoC compilation and controlled CTF challenge validation through `write_root_file`, `read_root_file`, and `uaf` modes.
- The Skill complements userspace security analysis by validating whether supported local privilege-escalation vulnerabilities are exploitable on the current kernel.
- See the [complete kernel security workflow](skills/alibabacloud-ecs-sec-kernel/SKILL.md).
- ## Prerequisites
- Requirements depend on the selected Skill:
- | Skill | Requirements |
- | --- | --- |
- | Linux OS troubleshooting | Local: target-side shell and OS permissions, no cloud tools required. Remote: configured [aliyun CLI](https://github.com/aliyun/aliyun-cli) with relevant plugins, or authorized [OpenAPI MCP](https://help.aliyun.com/zh/openapi/user-guide/openapi-mcp-server-guide). |
- | Windows OS troubleshooting | Local GuestOS execution requires PowerShell only; remote execution requires aliyun CLI v3.4.11+, `aliyun-cli-ecs`, a running instance, and Cloud Assistant Agent |
- | Userspace security detection | Linux x86_64, Python 3.11+, and root/sudo access |
- | Kernel CVE detection | Linux x86_64, Python 3.8+, root/sudo access, kernel-module loading capability, and an isolated recoverable environment for PoC execution |
- Consult each Skill's `SKILL.md` and referenced RAM policy before granting permissions or running diagnostics.
- ## Installation
- Install all Skills globally with [skills.sh](https://skills.sh):
- ```bash
- npx skills add aliyun/alibabacloud-ecs-troubleshoot-skills -g
- ```
- Alternatively, install them manually:
- ```bash
- git clone https://github.com/aliyun/alibabacloud-ecs-troubleshoot-skills.git
- mkdir -p ~/.agents/skills
- cp -r alibabacloud-ecs-troubleshoot-skills/skills/* ~/.agents/skills/
- ```
- For the CLI cloud-access path, configure aliyun CLI and install plugins as needed:
- ```bash
- aliyun configure
- aliyun plugin install --names aliyun-cli-ecs
- # Optional: required only when the Linux Skill queries CloudMonitor metrics
- aliyun plugin install --names aliyun-cli-cms
- # Optional: required only when the Linux Skill queries ActionTrail operation history
- aliyun plugin install --names aliyun-cli-actiontrail
- ```
- Local Linux shell diagnosis and Windows diagnosis performed directly inside the GuestOS do not require aliyun CLI.
- ### Linux OpenAPI MCP Setup
- Configure a server in your agent client using the official [OpenAPI MCP Server guide](https://help.aliyun.com/zh/openapi/user-guide/openapi-mcp-server-guide):
- ## Quick Start
- After installation, describe the target instance and symptom to your AI agent. For example:
- - “Diagnose high CPU on this ECS Linux machine.”
- - “Diagnose SSH failure on ECS Linux instance `i-xxx` in `cn-shanghai`. Use the configured OpenAPI MCP.”
- - “Investigate why RDP connections to this ECS Windows instance fail.”
- - “Check this Linux server for signs of compromise and produce an evidence report.”
- - “Assess this Linux kernel for supported local privilege-escalation CVEs.”
- The agent selects the matching Skill, validates required inputs and permissions, gathers evidence, and reports conclusions according to that Skill's workflow.
- ## Security Notes
- > [!CAUTION]
- > Kernel PoCs can crash or destabilize a system. Run them in an isolated virtual machine or snapshot-enabled environment.
- - Grant only the RAM and operating-system privileges required by the selected workflow.
- - Review each proposed action before allowing an agent to modify a production instance.
- - Review every action yourself and take responsibility for the outcome.
- ## Contributing
- Contributions are welcome through Issues and Pull Requests.
- - New Skills must follow the [Agent Skills specification](https://agentskills.io/).
- - Use [Conventional Commits](https://www.conventionalcommits.org/) for commit messages.
- - All contributions must be suitable for public release.
- - Troubleshooting steps must be reproducible and include clear evaluation criteria.
- ## Related Links
- - [Alibaba Cloud ECS self-service troubleshooting](https://ecs.console.aliyun.com/troubleshooting)
- - [Agent Skills specification](https://agentskills.io/)
- - [aliyun CLI](https://github.com/aliyun/aliyun-cli)
- ## License
- This project is licensed under the [Apache License 2.0](LICENSE).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.