skills.rest
PavelLizunov
PavelLizunovCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/PavelLizunov/VPNRouter --skill diagnose-config
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
yzhao062yzhao062
13

nsf-proposal-guardrail

Ingest NSF solicitation text into a normalized requirements baseline.

Community
Advanced
JohanChaneJohanChane
629

generating-sing-box-configs

Generate sing-box configuration files for client, server, and TUN setups.

Community
Advanced
gagan114662gagan114662

linux-networking

Configure iptables and nftables firewall rules for Linux networking.

Community
Advanced
AstorYHAstorYH
15

ping-latency-tester

Measure round-trip time to a specified network address.

Community
Basic