clash-doctor

Diagnose Clash Verge network issues and configure AI tool routing rules.

258|26|Updated Dec 9, 2025
One-click install
npx skills add https://github.com/majiayu000/spellbook --skill clash-doctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clash-doctor
Source: https://github.com/majiayu000/spellbook/tree/main/skills/clash-doctor
Command: npx skills add https://github.com/majiayu000/spellbook --skill clash-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Clash Verge Diagnostics provides a structured workflow to diagnose network issues, configure AI tool routing rules for Claude Code, Codex, Cursor, and Warp, and manage subscription configurations and profile switches.

Core Features & Use Cases

  • Network diagnostics and connectivity checks across local and proxy setups.
  • AI routing rule configuration with templates for Claude Code, Codex, Cursor, and Warp, plus easy subscription management (view/clone/switch).
  • Safe, step-by-step workflow with guidance and rollback options for troubleshooting and config optimization.

Quick Start

Analyze a failing connection, load the full-guide, and execute the smallest reversible action to restore connectivity.

Frequently Asked Questions about clash-doctor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure Clash Verge routing rules for AI tools like Claude Code and Cursor?

Configuring Clash Verge routing rules for AI tools like Claude Code and Cursor is done by applying deterministic overlays for merge, rules, proxies, and groups. The workflow provides specific templates to establish correct routing for Claude Code, Codex, Cursor, and Warp.

Why is my Clash Verge proxy connection failing and how can I diagnose it?

Diagnosing Clash Verge proxy connection failures involves running network diagnostics and connectivity checks across local and proxy setups. The workflow analyzes the failing connection and executes the smallest reversible action to restore connectivity safely.

Can I switch and manage multiple subscription configurations in Clash Verge?

Yes, you can manage multiple subscription configurations in Clash Verge. The workflow supports viewing, cloning, and switching subscription profiles to help manage different proxy setups and optimize configurations.

Does Clash Verge diagnostics support a rollback safety mechanism for configuration changes?

Yes, Clash Verge diagnostics supports a rollback safety mechanism. It operates using deterministic overlays and provides a safe, step-by-step workflow with guidance and rollback options for troubleshooting and configuration optimization.

What is the best way to troubleshoot network connectivity across Claude Code, Codex, and Warp?

The best way to troubleshoot network connectivity across Claude Code, Codex, and Warp is to load the full-guide references and run structured network diagnostics. This process checks connectivity across local and proxy setups to identify and resolve issues.