diagnose-config

Diagnose VPNRouter connectivity issues by cross-referencing config.yaml with sing-box runtime states.

3|1|Updated Feb 20, 2026

Search Tags:#debugging #troubleshooting #vpn #networking #configuration #sing-box

Ready to run

npx skills add https://github.com/PavelLizunov/VPNRouter --skill diagnose-config

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: diagnose-config
Source: https://github.com/PavelLizunov/VPNRouter/tree/main/.agents/skills/diagnose-config
Command: npx skills add https://github.com/PavelLizunov/VPNRouter --skill diagnose-config

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill resolves complex VPN connectivity issues by methodically comparing the user's configuration state against the actual runtime environment, identifying silent leaks, and detecting configuration mismatches.

Core Features & Use Cases

Configuration Audit: Validates the consistency between the UI-generated config.yaml and the active sing-box current.json.
Log Analysis: Parses vpnrouter logs to identify startup failures, process scanning errors, and subscription resolution issues.
Use Case: When a user reports that specific applications are bypassing the VPN or the connection fails to establish, this skill traces the routing rules and outbound tags to pinpoint the exact point of failure.

Quick Start

Use the diagnose-config skill to analyze the provided config.yaml, current.json, and vpnrouter.log files to identify the cause of the connection failure.

Frequently Asked Questions about diagnose-config

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

FAQPage Schema

How do I troubleshoot sing-box configuration mismatches causing VPN connection failures?▼

Diagnose VPN split-tunneling leaks by analyzing vpnrouter logs and validating routing rules against outbound tags. This traces traffic to pinpoint specific applications bypassing the VPN through silent routing misconfigurations.

Can I use this to debug VPNRouter connectivity issues on macOS and Linux?▼

Diagnose VLESS protocol mismatches by cross-referencing user-defined settings with active sing-box runtime states. This validates outbound configurations in current.json against expected VLESS parameters to identify protocol-level inconsistencies.

Why does my VPN traffic bypass the split-tunneling rules silently?▼

Troubleshoot sing-box configuration mismatches by cross-referencing user-defined config.yaml with the active current.json runtime state. This validates consistency between UI-generated settings and active outbounds to pinpoint the exact failure point.

How do I diagnose VLESS protocol mismatches in my VPN setup?▼

VPN traffic bypasses split-tunneling rules silently due to inconsistencies between config.yaml and active sing-box outbounds. Comparing routing rules and outbound tags identifies the exact misconfiguration allowing traffic to leak.

What is the best way to detect silent traffic leaks in a sing-box VPN setup?▼

Detect silent traffic leaks by parsing vpnrouter logs to identify startup failures and process scanning errors. Systematic validation of JSON outbound configurations ensures secure and correct routing across Windows, macOS, and Linux environments.