wsl-vscode-doctor SKILL.md skillA
wsl-vscode-doctor from atman-33/workhub is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add atman-33/workhub/wsl-vscode-doctor@git:20260901.114c610Pins git:20260901.114c610 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- atman-33/workhub
- Path
plugins/agent-ops/skills/wsl-vscode-doctor/SKILL.md- Versions recorded
- 1
- Latest version
- git:20260901.114c610, committed Sep 1, 2026
- Size
- 3,875 bytes
- Repository stars
- 3
- License
- MIT
Diagnose and fix `code .` failing to launch, or opening a disconnected Windows-side VS Code instead of a WSL-connected (Remote-WSL) window, in a herdr-spawned WSL shell.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
## Task Diagnose why `code .` doesn't work (or opens the wrong window) in this WSL shell, and patch `~/.zshrc` so it works going forward. ## Steps 1. **Check current state.** Run: ```bash command -v code echo "WSL_DISTRO_NAME=$WSL_DISTRO_NAME" echo "$PATH" | tr ':' '\n' | grep -i "Microsoft VS Code" ``` > **Why check both?** The `code` launcher script shipped by the Windows > VS Code install detects "am I in WSL" via `$WSL_DISTRO_NAME`. Without > it, `code .` still runs, but it skips routing through the Remote-WSL > extension and opens a disconnected Windows-side window instead. Completion criterion: `code` resolves on `PATH` AND `WSL_DISTRO_NAME` is set. If both are true, report "already configured" and stop — no further steps needed. 2. **Locate the VS Code Windows install** (don't hardcode a username): ```bash VSCODE_BIN=$(ls -d /mnt/c/Users/*/AppData/Local/Programs/"Microsoft VS Code"/bin 2>/dev/null | head -1) ``` Completion criterion: `$VSCODE_BIN` is a directory containing a `code` file. If nothing is found, report that VS Code isn't installed on the Windows side and stop. …
Read the whole file at its exact version.
How to install
mdr add atman-33/workhub/wsl-vscode-doctor@sha256:d586d70b3b368e15The line at the top of this page pins the label git:20260901.114c610, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_6yfq566gnwxmjoke)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Sep 1, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (3875 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
atman-33/workhub · 3 stars · license MIT · pushed 2026-10-15 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_6yfq566gnwxmjoke GET https://markdownregistry.com/api/v1/resolve?ref=atman-33/workhub/wsl-vscode-doctor GET https://markdownregistry.com/api/v1/blob/d586d70b3b368e159662288de170f0fc4f4856042c4f1fec9790f451479fe678
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.