wsl_doctor
OfficialDiagnose and repair WSL2 issues fast.
AuthorProwlrBot
Version1.0.0
Installs0
System Documentation
What problem does it solve?
WSL2 environments often fail to start or function correctly due to issues in the WSL service, VHDX health, networking, memory, or Hyper-V configuration. This skill provides a structured, multi-level diagnostic workflow to quickly identify the root cause and guide safe, effective repairs.
Core Features & Use Cases
- Progressive diagnostic ladder: from a quick health check (Level 1) to deep diagnostics (Levels 2-10) and recovery steps.
- End-to-end remediation guidance: covers WSL service state, VHDX integrity, networking/DNS, memory and performance tuning, systemd usage, GPU passthrough issues, and time synchronization.
- Distro-specific and environment-aware support: handles scenarios where distros fail to boot, are registered incorrectly, or file access to Windows drives is impaired.
Quick Start
Initiate the diagnostic ladder with a quick health check to begin automatic diagnosis and repair of common WSL2 problems.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: wsl_doctor Download link: https://github.com/ProwlrBot/prowlrbot/archive/main.zip#wsl-doctor Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.