Agent skill

Proxy Fleet

by imraywang in imraywang/proxy-fleet

Manage multiple VPS proxy nodes: deploy 3x-ui + VLESS+Reality, generate Clash/Mihomo subscription URLs, and keep them in sync.

MITAuto-check passedDevOps & Cloud

Install Proxy Fleet

skills CLI
$ npx skills add imraywang/proxy-fleet --skill proxy-fleet -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install imraywang/proxy-fleet proxy-fleet --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
proxy-fleet
GitHub stars
173
Token cost
~1.2k tokens
SKILL.md length
402 words
Files
9 (incl. scripts)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Manage multiple VPS proxy nodes: deploy 3x-ui + VLESS+Reality, generate Clash/Mihomo subscription URLs, and keep them in sync.

  • The user mentions proxy servers
  • SKILL.md covers Working Directory, Commands, When to Use Each Command and Deploy Flow, plus 3 more sections
  • Runs Python scripts from its folder; calls python3 and ssh
  • Clash subscriptions

What it does

Proxy Fleet is an agent skill from imraywang/proxy-fleet. Manage multiple VPS proxy nodes: deploy 3x-ui + VLESS+Reality, generate Clash/Mihomo subscription URLs, and keep them in sync. Use this skill whenever the user mentions proxy servers, VPS deployment, 3x-ui, VLESS, Reality, Clash subscriptions, proxy fleet management, adding/removing proxy nodes, updating proxy rules, or checking proxy node status. Also trigger when the user says "部署代理", "代理节点", "订阅链接", "分流规则", or references their VPS proxy infrastructure in any way.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including scripts (for example `README.md`, `README_CN.md` and `config.example.json`).

It sits in DevOps & Cloud, covering Deployment. The repository describes itself as: One-command VPS proxy fleet management: deploy 3x-ui + VLESS+Reality, auto-generate Clash/Mihomo subscriptions. The licence is MIT.

When your agent uses it

  • The user mentions proxy servers
  • Clash subscriptions
  • Proxy fleet management
  • Adding/removing proxy nodes

Example prompts

  • “/proxy-fleet”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit a588266. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • ssh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use ssh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Proxy Fleet loads about 1.2k tokens when it runs. Until then it costs about 121 tokens; SKILL.md has 402 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~121
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from imraywang/proxy-fleet at commit a588266, republished under its MIT licence (© imraywang). 402 words, ~1,216 tokens.

Download SKILL.mdSave it as .claude/skills/proxy-fleet/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.
name
proxy-fleet
description
Manage multiple VPS proxy nodes: deploy 3x-ui + VLESS+Reality, generate Clash/Mihomo subscription URLs, and keep them in sync. Use this skill whenever the user mentions proxy servers, VPS deployment, 3x-ui, VLESS, Reality, Clash subscriptions, proxy fleet management, adding/removing proxy nodes, updating proxy rules, or checking proxy node status. Also trigger when the user says "部署代理", "代理节点", "订阅链接", "分流规则", or references their VPS proxy infrastructure in any way.

proxy-fleet

Manage multiple VPS proxy nodes from a single command line. Deploy 3x-ui + VLESS+Reality and generate Clash/Mihomo subscription URLs that auto-sync when nodes change.

Working Directory

bash
cd /Users/wangzhuc/proxy-fleet

Commands

All commands run from the project root:

bash
python3 scripts/fleet.py init                              # First-time setup
python3 scripts/fleet.py status                            # Parallel health check
python3 scripts/fleet.py deploy <host> [--name X --emoji 🇯🇵]  # One-click deploy
python3 scripts/fleet.py deploy <host> --nat 10000-10009   # NAT machine
python3 scripts/fleet.py remove <host>                     # Remove from subscription
python3 scripts/fleet.py sync                              # Regenerate subscription YAML
python3 scripts/fleet.py upgrade <host> [host...]          # Upgrade 3x-ui, keep settings, pin Xray

When to Use Each Command

User saysCommand
"加台机器 / deploy / 部署代理"deploy <ssh-host>
"删掉这个节点 / remove"remove <ssh-host>
"节点状态 / 看下代理"status
"更新规则 / 加个 AI 域名"Edit templates/rules/*.yaml → sync
"刷新订阅 / 同步"sync

Deploy Flow

SSH → scan ports (avoid conflicts) → pick available port
  → install 3x-ui → reset credentials via CLI
  → generate x25519 keys → create VLESS+Reality inbound via API
  → detect firewall (ufw/iptables) → open ports
  → verify connectivity → save to config.json → sync subscription

Key Files

FilePurpose
config.jsonFleet state — credentials, nodes, subscription hosting (gitignored)
config.example.jsonTemplate for new users
scripts/fleet.pyMain CLI — all operations
templates/rules/ai.yamlAI service routing rules (OpenAI, Claude, Gemini, etc.)
templates/rules/proxy.yamlCommon proxy rules (Google, GitHub, Twitter, etc.)
templates/rules/streaming.yamlStreaming rules (YouTube, Netflix, etc.)
templates/rules/direct.yamlChina-direct and LAN rules

Updating Rules

Edit the relevant file in templates/rules/, then run sync to regenerate and upload the subscription. Users refresh in Clash Verge Rev to get changes.

sync publishes three files under subscription.file_path: config.yaml (Clash/mihomo), shadowrocket.txt (Shadowrocket node subscription, base64 vless:// links) and shadowrocket.conf (Shadowrocket rules/groups; groups use policy-regex-filter, so the conf never names a node). Inline rules in templates/rules/ feed both; group names are mapped via SR_POLICY_MAP.

Show full SKILL.md (219 more words)Show less

Technical Notes

These matter when debugging or extending the skill:

  • Xray v26+ key format: x25519 outputs PrivateKey / Password (= public key) / Hash32. Older versions use Private key / Public key. The script handles both.
  • 3x-ui install is interactive — the script installs with defaults, then resets credentials via the /usr/local/x-ui/x-ui setting CLI.
  • 3x-ui API: POST /login → session cookie → /panel/api/inbounds/{add,update,del,list}.
  • Reality returns HTTP 400 to non-VLESS clients — the connectivity check treats 400 as alive.
  • Port conflicts are the #1 deploy failure cause — the script scans ports before configuring.
  • Xray is pinned below the panel's bundled core (XRAY_VERSION): Xray >= v26.9.8 rejects REALITY ClientHellos without X25519MLKEM768, which locks Shadowrocket out. Clash needs support-x25519mlkem768: true (generated). Don't raise the pin without probing Shadowrocket.
  • REALITY minClientVer: Xray v26.7.x defaults an empty value to 26.3.27; mihomo reports 1.8.2 and would be refused. Inbounds are created with an explicit "0.0.0".
  • sync order: rule sets are mirrored before configs are published, and every file is written to .tmp then mv'd — a config must never reference a ruleset the host can't serve.
  • Ruleset mirror cron: sync installs /etc/cron.d/proxy-fleet-mirror on the subscription host (daily 04:17, script /usr/local/sbin/proxy-fleet-mirror.sh). The script validates the zstd magic before replacing any live .mrs, so a bad upstream day only means a stale mirror.
  • xray binary path is auto-detected via glob (/usr/local/x-ui/bin/xray-linux-*), works on both amd64 and arm64.

© imraywang, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 8 other files (scripts) in the repository root of imraywang/proxy-fleet.

  • SKILL.md
  • .gitignore
  • LICENSE
  • README.md
  • README_CN.md
  • config.example.json
  • scripts/fleet.py
  • templates/rules/ai.yaml
  • templates/rules/direct.yaml

Open the folder on GitHubat commit a588266

Compare with similar skills

Proxy Fleet next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Proxy Fleet compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Proxy Fleet this skillimraywang/proxy-fleet173—~1.2kAutomated safety check: PassMIT
Kubeshark Installerkubeshark/kubeshark12k—~3.6kAutomated safety check: NotesApache-2.0
GreptimeDB Dev Docker ImageGreptimeTeam/greptimedb6.7k—~4kAutomated safety check: NotesApache-2.0
KubeSphere ServiceMesh Managerkubesphere/kubesphere17k—~2.4kAutomated safety check: PassCustom licence
Vercelremotion-dev/remotion62k—~1.2kAutomated safety check: PassCustom licence
AWS Cdk Developmentzxkane/aws-skills3672 repos~2.5kAutomated safety check: PassMIT

Similar skills

  • Kubeshark Installer

    kubeshark/kubeshark

    Installs and configures Kubeshark on a Kubernetes cluster, choosing between the quick CLI path and a Helm install with custom values.

    12k GitHub stars~3.6k tokensUpdated 7 days ago
    DevOps & CloudAuto-check: notes
  • GreptimeDB Dev Docker Image

    GreptimeTeam/greptimedb

    Packages a locally built GreptimeDB debug binary into a development-only Docker image for local-cluster testing, with an optional push to a dev registry.

    6.7k GitHub stars~4k tokensUpdated 2 days ago
    DevOps & CloudAuto-check: notes
  • KubeSphere ServiceMesh Manager

    kubesphere/kubesphere

    Installs, checks and troubleshoots the KubeSphere ServiceMesh extension (Istio, Kiali, Jaeger), including grayscale release, sidecar injection, topology and tracing issues.

    17k GitHub stars~2.4k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • Vercel

    remotion-dev/remotion

    Official

    Set up a Codex monitor for Vercel deployments and preview URLs.

    62k GitHub stars~1.2k tokensUpdated today
    DevOps & CloudAuto-check passed
  • AWS Cdk Development

    zxkane/aws-skills

    AWS Cloud Development Kit (CDK) expert for building cloud infrastructure with TypeScript/Python.

    367 GitHub starsUsed in 2 repos~2.5k tokens
    DevOps & CloudAuto-check passed
  • Senior DevOps Toolkit

    maslennikov-ig/claude-code-orchestrator-kit

    Comprehensive DevOps skill for CI/CD, infrastructure automation, containerization, and cloud platforms (AWS, GCP, Azure). Includes pipeline setup…

    259 GitHub starsUsed in 6 repos~1.1k tokens
    DevOps & CloudAuto-check: notes

Categories

Questions about Proxy Fleet

What does Proxy Fleet do?

Manage multiple VPS proxy nodes: deploy 3x-ui + VLESS+Reality, generate Clash/Mihomo subscription URLs, and keep them in sync. Proxy Fleet is an agent skill from imraywang/proxy-fleet. Manage multiple VPS proxy nodes: deploy 3x-ui + VLESS+Reality, generate Clash/Mihomo subscription URLs, and keep them in sync.

When should I use Proxy Fleet?

Proxy Fleet fits situations like: the user mentions proxy servers; clash subscriptions; proxy fleet management; adding/removing proxy nodes.

How do I install Proxy Fleet in Claude Code?

Run `npx skills add imraywang/proxy-fleet --skill proxy-fleet -a claude-code`. Or copy the skill folder (the imraywang/proxy-fleet repository) into .claude/skills/proxy-fleet in your project. Claude Code loads it when a task matches its description.

How do I install Proxy Fleet in Codex?

Run `npx skills add imraywang/proxy-fleet --skill proxy-fleet -a codex`. Or copy the skill folder (the imraywang/proxy-fleet repository) into .agents/skills/proxy-fleet in your project. Codex loads it when a task matches its description.

Can I use Proxy Fleet in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add imraywang/proxy-fleet --skill proxy-fleet -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/proxy-fleet, .gemini/skills/proxy-fleet, .github/skills/proxy-fleet and .opencode/skills/proxy-fleet in your project.

What does Proxy Fleet need to run?

Going by SKILL.md and its folder, Proxy Fleet needs Python for the scripts in its folder and the command-line tools its instructions call (python3 and ssh). Our summary lists: Python 3.

Does Proxy Fleet access the network?

SKILL.md contains no URLs. Its commands use ssh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Proxy Fleet safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Proxy Fleet use?

Proxy Fleet is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Proxy Fleet use?

About 1.2k tokens (SKILL.md is roughly 4.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Proxy Fleet?

Skills that share tags, products or a category with Proxy Fleet: Kubeshark Installer (kubeshark/kubeshark, 12k stars), GreptimeDB Dev Docker Image (GreptimeTeam/greptimedb, 6.7k stars), KubeSphere ServiceMesh Manager (kubesphere/kubesphere, 17k stars) and Vercel (remotion-dev/remotion, 62k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Proxy Fleet?

imraywang (a GitHub user) maintains it in imraywang/proxy-fleet, which has 173 GitHub stars. The repository was last updated on September 30, 2026.

Source: imraywang/proxy-fleet on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.