windows-remote-desktop-connection-doctor

An agent skill by daymade, from daymade/claude-code-skills. Tags: debugging, desktop, troubleshooting, vpn, windows.

What it does

Diagnose Windows App (Microsoft Remote Desktop / Azure Virtual Desktop / W365 / direct PC) connection issues on macOS. Analyze transport protocol selection (UDP Shortpath vs WebSocket), detect VPN/proxy interference, parse Windows App logs for Shortpath failures, and resolve stuck "Configuring remote PC..." dialogs caused by expired Microsoft accounts, server reboots, or client-side auth poisoning. Use when VDI connections are slow or stuck, when direct PC connections fail to connect, when transport shows WebSocket instead of UDP, when RDP Shortpath fails, or when Windows App is frozen at a progress dialog.

Install

With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:

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

Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):

git clone --depth 1 https://github.com/daymade/claude-code-skills
cp -r claude-code-skills/windows-remote-desktop-connection-doctor ~/.claude/skills/windows-remote-desktop-connection-doctor

Safety box score

Not rated yet. A safety box score grades what a skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. Anyone can request one from this page; it is saved for everyone. How the score works.

Source

Repository

daymade/claude-code-skills (all skills from this repository)

Path

windows-remote-desktop-connection-doctor/SKILL.md

Branch

main

Updated

2026-09-20

Related skills

• tunnel-doctor — Diagnoses concrete tunnel and proxy-path failures across macOS and Windows/WSL: Tailscale routing, proxy env/system bypass, SSH double tunneling.
• agents-debug — Use when your agent or environment is broken — wrong answers, errors, timeouts, tool failures, or CLI issues. Reads traces and logs to diagnose root causes.
• app-platform-troubleshooting — Debug running App Platform applications by accessing containers, analyzing logs, running diagnostics, and applying fixes.
• chrome-mcp-troubleshooting — Diagnose and fix Claude in Chrome MCP extension connectivity issues.
• claude-skills-troubleshooting — Diagnose and resolve Claude Code plugin and skill issues. json.
• debugging-network-issues — Investigates network, streaming, and protocol failures with falsification-first layered experiments.