skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
majiayu000/spellbook133 installs

clash-doctor

Clash Verge 与 mihomo 诊断和 profile 管理。当用户遇到代理失败、需要配置 AI 工具路由、本地 Hub 拓扑、多机对齐、TUN 绕过、克隆或切换订阅,或同步后 配置未生效时使用。进程线路使用 clash-routes,出口 IP 质量使用 ip-check。 普通网络测速不使用。

How do I install this agent skill?

npx skills add https://github.com/majiayu000/spellbook --skill clash-doctor
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill provides Clash Verge diagnostics and configuration management, handling sensitive proxy credentials and modifying shell environment settings. While these actions are aligned with its intended purpose, they involve managing private connectivity data and modifying system startup files.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Clash Verge Diagnostics

Inspect Clash Verge or mihomo, manage profile-specific routing, and diagnose connectivity.

Routing

  • Confirm the target profile, constraints, requested access path, and done-when signal.
  • Load references/full-guide.md for commands, templates, and diagnosis matrices.
  • Load references/local-hub.md before hub, align, roles, clone, setup-ai, or switch, and whenever the user says a previous sync did not apply.
  • Keep the change limited to the requested target.

Safety

  • Diagnose and align are read-only. Writes require a shown summary and explicit confirmation.
  • Edit enhancement overlays or the confirmed local-hub YAML. Do not edit raw subscription dumps.
  • tun.route-exclude-address is union-only. DIRECT is not a TUN bypass.
  • Never invent or print node IPs, credentials, subscription UIDs, or machine hostnames.
  • After an overlay or hub-YAML write, quit and reopen Clash Verge. PUT /configs does not re-merge overlays.

Modes

ArgumentMode
empty or a hostnamediagnose
profiles / list / lslist local and remote profiles
statuslive kernel, TUN, and selected nodes
hub / roleslocal-hub topology
align / sync-checkread-only multi-machine comparison
switch-check / healthpre-switch health
clone / setup-ai / switchconfirmed profile writes
rustdesk / bypassTUN exclusion for a relay IP

Resolve the named target before setup-ai. Apply airport-style enhancement overlays only when that target is type: remote; edit the named hub YAML when it is type: local.

Verify

  • Parse the target YAML after every write.
  • Query mihomo by trying both Unix sockets and then the configured HTTP controller; fall back on request failure, not socket existence alone.
  • For routes, chains[-1] is the matched group and chains[0] is the dialed node.
  • Report files changed, commands run, evidence, and remaining risk.

References

  • references/full-guide.md — commands, templates, and diagnosis matrix
  • references/local-hub.md — hub ownership, node roles, alignment, and landmines

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/majiayu000/spellbook/clash-doctor">View clash-doctor on skillZs</a>