skills.rest
crystalzhangbai
crystalzhangbaiCOMMUNITY
Explore all skills by this author →
GitHub

vm-knowledge-search

Searches Azure VM troubleshooting knowledge across internal wikis, MS Learn, ICM, and vendor KBs.

Updated Aug 13, 2026
Search Tags:#troubleshooting#mcp#wiki#icm#knowledge search#azure vm#tsg
One-click install
npx skills add https://github.com/crystalzhangbai/TS-Agent-Azure --skill vm-knowledge-search-crystalzhangbai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: vm-knowledge-search
Source: https://github.com/crystalzhangbai/TS-Agent-Azure/tree/main/bridge/skills/vm-knowledge-search
Command: npx skills add https://github.com/crystalzhangbai/TS-Agent-Azure --skill vm-knowledge-search-crystalzhangbai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Azure VM support engineers waste time hunting for troubleshooting guides scattered across internal wikis, Microsoft Learn, incident systems, and Linux vendor documentation. This Skill runs a tiered, multi-source search workflow that finds the right TSG, KB article, or incident record and returns cited, ranked results. ## Core Features & Use Cases - Tiered multi-source search: Queries CSS Wiki (Supportability ADO) and Microsoft Learn in parallel by default, then auto-escalates to EngHub, ICM, azurewiki, Linux vendor KBs (Red Hat / SUSE / Ubuntu / Oracle), and public web search only when earlier tiers come up empty. - Topic-aware project routing: Maps query keywords to the right Supportability ADO projects (AzureNetworking, AzureLinuxNinjas, AzureBackup, WindowsEE, and 16 more) with a routing table, disambiguation rules, and a 4-project cap. - Failure recovery: Detects MCP timeouts and auth failures and falls back to the ADO REST API with an az-issued token, without blocking the response. - Use Case: A customer reports a SUSE Pacemaker SBD fencing issue. The Skill routes the search to AzureIaaSVM + AzureLinuxNinjas, fires csswiki and mslearn queries in parallel, reads the top TSG pages, and returns a synthesized answer with clickable source links. ## Quick Start Ask the assistant to find a troubleshooting guide for your Azure VM issue, for example: find the TSG for RDP internal error MachineKeys on Azure VMs.

Frequently Asked Questions about vm-knowledge-search

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

FAQPage Schema
How do I find Azure VM troubleshooting guides and TSGs?▼

Describe the VM issue or error code and the Skill searches CSS Wiki and Microsoft Learn in parallel, then reads the top matching pages. If defaults return nothing, it automatically escalates to EngHub, ICM, azurewiki, and vendor KBs before falling back to public web search.

What sources does Azure VM knowledge search cover?▼

Default sources are the Supportability CSS Wiki (20 ADO projects) and Microsoft Learn. On-demand sources include ICM incidents, EngHub (eng.ms) PG docs, azurewiki (msazure org), CSS work items, and Linux vendor KBs from Red Hat, SUSE, Ubuntu, and Oracle.

Can it search Red Hat, SUSE, or Ubuntu documentation for Linux VM issues?▼

Yes. When the query contains Linux or SAP HA signals like RHEL, SLES, Pacemaker, or kdump, the Skill fires site-scoped web_search queries against the matching vendor documentation sites. Users can also explicitly request a vendor KB lookup.

What happens when the csswiki MCP server fails or times out?▼

Timeouts trigger one retry with shorter keywords; persistent auth failures fall back to the ADO REST API using an az-issued bearer token. The user is always told which source failed and which fallback was used.

Does it search ICM incidents automatically?▼

ICM fires when the user mentions an incident ID, live-site issue, or similar incidents, or when default sources return empty. It supports keyword search via icm-search_incidents plus incident detail, AI summary, and similar-incident lookups by ID.

When should I not use this Skill?▼

It is designed for finding knowledge, not performing actions on VMs. For purely internal questions like PG design docs, public web fallback is skipped; for executing remediation steps, use an action-oriented skill instead.

Related Skills

Explore More Software Engineering Skills→
azaslonovazaslonov

skill-apim-skuv1-investigator

Investigate Azure API Management SKUv1 incidents using ICM, alerts, and Kusto telemetry.

Community
Advanced
fmflurryfmflurry
171

exceptions-draft-order-error-resolution

Diagnose and patch recurring errors with structured steps and guardrails.

Community
Intermediate
googlegoogle
68

dev-testing-vm

Run capsem-doctor diagnostics and manage test fixtures inside the guest VM.

Official
Intermediate
hjemmesidekongenhjemmesidekongen
1

azure-devops-pipeline

Query Azure DevOps pipeline status, trigger runs, and parse test results for the active branch.

Community
Advanced