Agent-Skills.md

Agent Skills: Clash Verge Diagnostics

>

UncategorizedID: majiayu000/claude-arsenal/clash-doctor

Repository

majiayu000/claude-arsenal
majiayu000License: MIT
28026

Install this agent skill to your local

pnpm dlx add-skill https://github.com/majiayu000/spellbook/tree/HEAD/skills/clash-doctor

Skill Files

Browse the full folder contents for clash-doctor.

Download Skill

Loading file tree…

skills/clash-doctor/SKILL.md

Skill Metadata

Name
clash-doctor
Description
>

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

| Argument | Mode | |---|---| | empty or a hostname | diagnose | | profiles / list / ls | list local and remote profiles | | status | live kernel, TUN, and selected nodes | | hub / roles | local-hub topology | | align / sync-check | read-only multi-machine comparison | | switch-check / health | pre-switch health | | clone / setup-ai / switch | confirmed profile writes | | rustdesk / bypass | TUN 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