daymade avatar

Windows Remote Desktop Connection Doctor

This is for when your Azure Virtual Desktop or Windows 365 connection on macOS feels sluggish and you need to figure out why you're stuck on WebSocket instead of UDP Shortpath. It walks through the full diagnostic path: parsing Windows App logs for STUN/TURN failures, checking if your VPN is swallowing UDP packets (look for that 198.18.0.x source IP), and testing whether your ISP just blocks UDP entirely. The methodology is thorough, covering everything from Tailscale netcheck output to ShadowRocket proxy rules, and it includes actual log patterns like "FetchClientOptions exception" that signal the client can't even negotiate transport options. If you've ever stared at high RTT wondering why your remote desktop feels like molasses, this gets you to the answer without guessing.

skills.sh installs
843
GitHub stars
1.5K
last updated
Aug 21, 2026

Install

$ npx -y skills add daymade/claude-code-skills --skill windows-remote-desktop-connection-doctor --agent claude-code

Installs into .claude/skills of the current project.

Files

Windows Remote Desktop Connection Doctor

Diagnose and fix Windows App (Microsoft Remote Desktop / AVD / WVD / W365 / direct PC) connection issues on macOS, with focus on transport protocol optimization and root-cause falsification.

Methodology base: the general evidence-driven diagnosis discipline lives in the debugging-network-issues skill. This skill is the Windows-App / AVD transport domain layer — it leans toward connection-quality optimization more than root-cause falsification, so the methodology overlap is lighter.

Background

Azure Virtual Desktop transport priority: UDP Shortpath > TCP > WebSocket. UDP Shortpath provides the best experience (lowest latency, supports UDP Multicast). When it fails, the client falls back to WebSocket over TCP 443 through the gateway, adding significant latency overhead.

Direct PC connections use plain RDP over TCP 3389 (usually TLS-wrapped). They have no Connection Info panel, no gateway reachability tests, and no transport optimization step. For direct PC, the dominant failure modes are:

Sponsors

Details

Repository
github.com/daymade/claude-code-skills
Categories
Backend & APIs, Debugging, Cloud & Infrastructure
First seen
Jun 3, 2026

More from daymade/claude-code-skills

All 53
1nvidia avatarnemoclaw-user-configure-inferencenvidia/skillsConnects NemoClaw to a local inference server. Use when setting up Ollama, vLLM, TensorRT-LLM, NIM, or any OpenAI-compatible local model server with NemoClaw. T841skills.sh installs
2harperfast avatarharper-best-practicesharperfast/skillsBest practices for building Harper applications, covering schema definition, automatic APIs, authentication, custom resources, and data handling. Triggers on ta819skills.sh installs
3auth0 avatarauth0-mfaauth0/agent-skillsUse when adding MFA or step-up authentication to an app — requiring users to verify with a second factor (TOTP, SMS, passkey, push) for login or before a sensit811skills.sh installs
4mindrally avataraspnet-coremindrally/skillsGuidelines for ASP.NET Core web development covering API design, authentication, caching, and best practices802skills.sh installs
5alchemyplatform avataralchemy-clialchemyplatform/skillsUse the Alchemy CLI (`@alchemy/cli`) for live blockchain data, transaction lookups, NFT/token/portfolio queries, simulation, tracing/debugging, account abstract800skills.sh installs
6alirezarezvani avatarcode-to-prdalirezarezvani/claude-skillsReverse-engineer any codebase into a complete Product Requirements Document (PRD). Analyzes routes, components, state management, API integrations, and user int798skills.sh installs