migrating-sing-box-configs
CommunityMigrate sing-box configs safely across versions
Software Engineering#validation#sing-box#config migration#dns rules#tls acme#wireguard endpoint#schema deprecation
AuthorJohanChane
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Prevents sing-box configuration breakage after upgrades by guiding version-by-version migrations and enforcing validation so deprecated or removed fields are handled correctly.
Core Features & Use Cases
- Version-to-version migration playbook: Provides documented field migrations across sing-box versions from 1.8.0 through 1.14.0 (e.g., DNS rule changes, TLS certificate provider changes, outbound/inbound schema shifts).
- Mandatory verification workflow: Ensures correctness by requiring
sing-box check -c <config>after each migration step, treating failures as a stop-and-fix signal. - Fallback guidance for unknown cases: When a field/version transition isn’t covered, prompts for official documentation sources and fetches the relevant migration guide before recommending changes.
Quick Start
Run this skill to migrate your existing sing-box config between the exact source and target versions, and after each step execute sing-box check on the updated config until the check passes.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: migrating-sing-box-configs Download link: https://github.com/JohanChane/clashtui/archive/main.zip#migrating-sing-box-configs Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.