windows-remote-desktop-connection-doctor

Diagnose Windows App RDP connection quality issues on macOS using transport and log analysis.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/HuuBar/skill-routing-experiment --skill windows-remote-desktop-connection-doctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: windows-remote-desktop-connection-doctor
Source: https://github.com/HuuBar/skill-routing-experiment/tree/main/unified_skills/daymade/windows-remote-desktop-connection-doctor
Command: npx skills add https://github.com/HuuBar/skill-routing-experiment --skill windows-remote-desktop-connection-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Diagnosing and fixing Windows App (AVD/WVD/W365) remote desktop connection quality issues on macOS, focusing on transport protocol optimization and log-based diagnostics.

Core Features & Use Cases

  • Collect connection info from the Windows App, including transport protocol, RTT, and gateway details.
  • Analyze network evidence for VPN/proxy interference, DNS manipulation, and NAT conditions that affect Shortpath.
  • Parse and compare Windows App logs to identify transport negotiation issues (STUN/TURN) and health check failures, then guide remediation.

Quick Start

Run the Windows Remote Desktop Connection Doctor to diagnose an AVD transport issue and verify Shortpath negotiation on macOS.

Frequently Asked Questions about windows-remote-desktop-connection-doctor

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

FAQPage Schema
How do I diagnose Azure Virtual Desktop connection quality issues on macOS?

Diagnose Azure Virtual Desktop connection quality on macOS by collecting transport protocol info, analyzing VPN or proxy interference, and parsing Windows App logs to identify STUN and TURN negotiation failures.

Why does my AVD session fall back to WebSocket instead of using Shortpath?

AVD sessions fall back to WebSocket when Shortpath negotiation fails due to NAT restrictions, VPN interference, or proxy conditions. Analyzing Windows App logs identifies the specific transport selection issue and STUN or TURN failure.

How do I check if my VPN is interfering with Windows Remote Desktop transport protocols?

Check VPN interference with Windows Remote Desktop by analyzing network evidence for DNS manipulation and proxy conditions. Parse Windows App logs on macOS to identify transport negotiation issues affecting RDP connection quality.

What causes STUN and TURN failures in Windows 365 remote desktop connections?

STUN and TURN failures in Windows 365 remote desktop connections are caused by NAT environments, VPN interference, and proxy conditions that block Shortpath negotiation. Log analysis identifies the specific network condition triggering the failure.

Can I troubleshoot WVD slow session performance by analyzing Windows App logs on macOS?

Troubleshoot WVD slow session performance on macOS by parsing Windows App logs to compare transport protocols, identify health check failures, and detect VPN or proxy interference affecting RDP transport selection and RTT.

What is the best way to verify Shortpath negotiation for Azure Virtual Desktop?

Verify Shortpath negotiation for Azure Virtual Desktop by fetching connection info from the Windows App on macOS, analyzing transport selection evidence, and parsing logs to confirm STUN and TURN flows bypass gateway fallback.