mihomo-config-plugin

mihomo-skill

中文 | English

A Claude Code Plugin Marketplace that distributes mihomo-config -- a reference skill that helps AI assistants understand and generate mihomo (Clash.Meta) YAML proxy configuration files.

What It Does

The mihomo-config skill gives your AI assistant deep knowledge of mihomo configuration, enabling it to:

• Generate complete, production-ready mihomo YAML configs from scratch
• Debug configuration issues (DNS leaks, routing problems, TUN failures)
• Explain any section of a mihomo config in detail
• Convert Clash configs to mihomo format

Coverage includes 20+ proxy protocols (Shadowsocks, VMess, VLESS, Trojan, Hysteria2, TUIC, WireGuard, and more), DNS configuration (fake-ip / redir-host), TUN mode transparent proxying, proxy groups with region filtering, 30+ routing rule types, and proxy/rule providers.

Skill Contents

File	Description
SKILL.md	Main entry point -- config structure, global settings, TUN, sniffer, common gotchas
reference/proxies.md	20+ proxy protocol configurations (SS, VMess, VLESS, Trojan, Hysteria2, TUIC, WireGuard, etc.)
reference/dns.md	DNS configuration (fake-ip, redir-host, fallback-filter, nameserver-policy)
reference/proxy-groups.md	Proxy group types and region filtering patterns
reference/rules-and-providers.md	30+ rule types, rule providers, proxy providers
examples/complete-config.yaml	Production-ready example configuration

All skill files are located under plugins/mihomo-config-plugin/skills/mihomo-config/.

Installation

Skills CLI (Recommended -- works with 40+ AI tools)

The most universal installation method. Supports Claude Code, Cursor, Windsurf, Trae, Cline, Roo Code, OpenCode, Gemini CLI, GitHub Copilot, and many more.

# Install to current project
npx skills add sd0ric4/mihomo-skill

# Install globally (available in all projects)
npx skills add sd0ric4/mihomo-skill -g

For more options, see skills.sh.

Claude Code Plugin Marketplace

From the Claude Code prompt:

/plugin marketplace add sd0ric4/mihomo-skill
/plugin install mihomo-config-plugin@mihomo-skills

Or from your terminal:

claude plugin marketplace add sd0ric4/mihomo-skill
claude plugin install mihomo-config-plugin@mihomo-skills

Manual Installation (any AI tool)

For tools not supported by the Skills CLI:

git clone https://github.com/sd0ric4/mihomo-skill.git

Then copy the skill directory to your tool's location:

Tool	Target path
Cursor	.cursor/skills/mihomo-config/
Windsurf	.windsurf/skills/mihomo-config/
Trae	.trae/skills/mihomo-config/
Cline / Roo Code	.agents/skills/mihomo-config/
Other	Your tool's rules / custom instructions directory

cp -r mihomo-skill/plugins/mihomo-config-plugin/skills/mihomo-config/ <target-path>

Or add the contents of SKILL.md and reference/*.md directly to your AI tool's context or knowledge base.

Usage Examples

After installation, try these prompts with your AI assistant:

• "Generate a mihomo config with TUN mode, fake-ip DNS, and proxy subscriptions for HK/JP/US regions"
• "Debug my mihomo config -- DNS keeps leaking"
• "Add a Hysteria2 node with port hopping to my config"
• "Convert this Clash config to mihomo format"

Contributing

Contributions are welcome. Please open an issue or submit a pull request on GitHub.

License

MIT

Credits

Built with Claude Code.