Tunnel Doctor
This is the skill you reach for when Tailscale ping works but SSH or HTTP mysteriously times out on macOS, or when your browser returns 503 but curl succeeds. It methodically walks through six conflict layers between Tailscale and proxy tools like Shadowrocket, Clash, or Surge: route hijacking, HTTP proxy environment variables, system proxy bypass, SSH ProxyCommand double tunneling, VM runtime proxy propagation in Docker and OrbStack, and stalled DNS resolvers that cause 60 second hangs. The diagnostic tables are excellent at distinguishing symptoms that look similar but have different root causes. It also covers SSH access to WSL instances over Tailscale, which has its own trap involving snap sandbox restrictions.
- skills.sh installs
- 713
- GitHub stars
- 1.5K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add daymade/claude-code-skills --skill tunnel-doctor --agent claude-codeInstalls into .claude/skills of the current project.
Files
Tunnel Doctor
Diagnose and fix conflicts when Tailscale coexists with proxy/VPN tools on macOS, with specific guidance for SSH access to WSL instances.
Methodology base: the general diagnostic discipline this skill builds on — evidence over assumption, falsification over confirmation, layered isolation, counter-review — lives in the debugging-network-issues skill. This skill is the macOS Tailscale⨯proxy domain layer on top of it; reach for the base skill when the symptom is not a known Tailscale/proxy conflict.
Ownership boundary: this skill owns concrete local network-path operations:
Tailscale, route/DNS/proxy interception, VM/WSL propagation, TUN forwarding
planes, and proxy node/exit/chain capacity. Use debugging-network-issues as the
general method when the boundary is still unknown or the symptom belongs to
SSE/CDN/application protocol behavior. This keeps one concrete operator instead
of forcing the user to choose between two overlapping proxy doctors.
Target and task scope
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/daymade/claude-code-skills
- Categories
- Backend & APIs, DevOps & CI/CD, Git & Pull Requests, Debugging, Automation & Workflows, Python
- First seen
- Jun 3, 2026
More from daymade/claude-code-skills
All 53- Debugging Network Issues710
- Competitors Analysis694
- Slides Creator686
- Continue Claude Work631
- Markdown Tools169
- Twitter Reader3.3K
- I18n Expert2.7K
- Prompt Optimizer2.1K
- Qa Expert2K
- Ppt Creator2K
- Transcript Fixer1.9K
- Macos Cleaner1.9K
- Deep Research1.8K
- Asr Transcribe To Text1.7K
- Ui Designer1.7K
- Ima Copilot1.6K
- Promptfoo Evaluation1.6K
- Fact Checker1.6K
- Meeting Minutes Taker1.6K
- Github Ops1.6K
- Developing Ios Apps1.5K
- Excel Automation1.5K
- Youtube Downloader1.5K
- Mermaid Tools1.5K
Recommended
More Backend & APIs
orpc-contract-firstlanggenius/difyGuide for implementing oRPC contract-first API patterns in Dify frontend. Trigger when creating or updating contracts in web/contract, wiring router composition713skills.sh installs
vueuni-helper/skillsVue.js progressive JavaScript framework. Use when building Vue components, working with reactivity (ref, reactive, computed, watch), or implementing Vue Composi713skills.sh installs
next-best-actionjoellewis/finance_skillsDesign and implement next-best-action engines that surface proactive, prioritized recommendations to advisors based on portfolio, life, market, and compliance e712skills.sh installs
debugging-network-issuesdaymade/claude-code-skillsEvidence-driven investigation for network, streaming, and protocol-layer bugs where symptoms don't match the obvious cause. Use when debugging connection resets710skills.sh installs
workout-program-designeronewave-ai/claude-skillsCustom training plans by goal (strength, cardio, flexibility). Progressive overload programming, rest day optimization, home vs gym adaptations, deload weeks.707skills.sh installs
openocdzhinkgit/embeddedskillsOpenOCD 下载与调试工具，用于探针探测、固件烧录、Flash 擦除、GDB Server 启动、目标复位控制、 Telnet 在线调试（halt/resume/step/寄存器/内存/断点）、GDB 源码级调试，以及 Semihosting/ITM 输出捕获和底层查询。 当用户提到 OpenOCD、ST-Link707skills.sh installs