feat: add docker-via-wsl skill for Windows hosts using WSL2 backend#36
Conversation
Adds a second skill, docker-via-wsl, for AI agents running on a Windows host *outside* WSL (Git Bash/MSYS/PowerShell). Docker Desktop's daemon lives in the WSL2 VM, so every docker/docker compose command must be re-issued inside WSL via wsl.exe — running them from a Windows shell on a network/SMB drive (Z:, UNC) corrupts bind-mount path translation and surfaces as "could not read from input file: Is a directory". The skill ships as a standalone skill rather than a docker-development reference because docker-development/SKILL.md is at its 500-word ceiling and because the WSL gotcha needs its own broad trigger (it fires on any docker command from a Windows shell, not only on docker-development work). - skills/docker-via-wsl/SKILL.md — when-it-applies / problem / rule - skills/docker-via-wsl/references/diagnosis-and-fix.md — inspect mounts, compare host vs container views, clean up a phantom bind directory - register the skill in .claude-plugin/plugin.json - document both skills in README.md and AGENTS.md Closes #32 Signed-off-by: Sebastian Mendel <info@sebastianmendel.de>
Dependency Review✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.Scanned FilesNone |
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request introduces a new skill, docker-via-wsl, designed for AI agents operating on Windows hosts outside of WSL. It provides guidelines and reference documentation on executing Docker commands inside WSL via wsl.exe to prevent path corruption issues with bind mounts. The changes include updates to the plugin configuration, README, AGENTS documentation, and the addition of the new skill definition and diagnosis guide. There are no review comments to address, and I have no additional feedback to provide.
Important
The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.
|
1 participant
Closes #32
What
Adds a second skill,
docker-via-wsl, for AI agents running on a Windows host outside WSL (Git Bash/MSYS/PowerShell). Docker Desktop's daemon lives in the WSL2 VM, so everydocker/docker composecommand must be re-issued inside WSL viawsl.exe. Running them from a Windows shell on a network/SMB drive (Z:, UNC) corrupts bind-mount path translation and surfaces as the classiccould not read from input file: Is a directory.Why a standalone skill (not a
docker-developmentreference)The issue proposed it as a standalone skill, and two factors confirm that form:
docker-development/SKILL.mdis at 498/500 words (the repo enforces a 500-wordwc -wceiling). It cannot absorb a new topic + its trigger keywords without cutting the maintainer's existing core content.docker ps), which is orthogonal to "doing docker development". A dedicated skill description gives that broad, precise trigger.The plugin already exposes a
skillsarray, so multi-skill is supported at the plugin/marketplace level.Changes
skills/docker-via-wsl/SKILL.md— when-it-applies / the problem / why it matters / the rule (frontmatter conformed to repo conventions: split license,metadata.versionsynced to1.9.1, scopedallowed-toolslike the sibling skill rather than the issue's bareBash).skills/docker-via-wsl/references/diagnosis-and-fix.md— inspect the mounted path, compare host vs container views, clean up a phantom bind directory..claude-plugin/plugin.json— register the new skill in theskillsarray.README.md,AGENTS.md— document both skills (also fills in the already-missingbind-mount-ownership.mdentry in the AGENTS.md tree/index).Verification (local)
validate-skill.sh→ 0 errors (6 pre-existing README-template warnings, unchanged frommain).check-version-parity.sh→ plugin.json and bothSKILL.mdmetadata.versionmatch at1.9.1.docker-development498,docker-via-wsl499 (≤ 500).markdownlint-cli2→ 0 errors on all changed markdown.scripts/verify-harness.sh→ Harness Maturity Level 3 (Enforced), complete.No version bump in this PR — the maintainer's release flow (chore(release) commit + signed tag) bumps
plugin.jsonand everySKILL.mdtogether.🤖 Generated with Claude Code