New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Vpn Deploy

by Sergei-thinker in Sergei-thinker/vpn-setup

Guided VPN deployment wizard. An agent skill from Sergei-thinker/vpn-setup.

MITAuto-check: notesDevOps & Cloud

Install Vpn Deploy

skills CLI
$ npx skills add Sergei-thinker/vpn-setup --skill vpn-deploy -a claude-code

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

GitHub CLI
$ gh skill install Sergei-thinker/vpn-setup vpn-deploy --agent claude-code

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

Manual copy
$ git clone --depth 1 https://github.com/Sergei-thinker/vpn-setup.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/vpn-deploy .claude/skills/vpn-deploy && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

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

Facts

Skill name
vpn-deploy
GitHub stars
189
Token cost
~1.4k tokens
SKILL.md length
709 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
MIT

At a glance

Guided VPN deployment wizard. An agent skill from Sergei-thinker/vpn-setup.

  • Works in 6 steps: Environment Setup → Dependency Check → Connectivity Test → …
  • User says deploy VPN
  • SKILL.md covers When to Use, The Iron Law, Workflow and Communication Rules
  • Calls python, python3 and pip; needs VPN_SSH_KEY

What it does

Vpn Deploy is an agent skill from Sergei-thinker/vpn-setup. Guided VPN deployment wizard. Use when user says 'deploy VPN', 'deploy my VPN', 'set up VPN', 'install VPN'. Also use when opening the project for the first time and user wants to get started.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud, covering Deployment. It works with Python. The repository describes itself as: Multi-layer VPN (VLESS Reality + Yandex Cloud Relay + WebRTC) for bypassing Russian internet censorship. Automated deployment via Claude Code. The licence is MIT.

When your agent uses it

  • User says deploy VPN
  • Opening the project for the first time and user wants to get started

Example prompts

  • “deploy VPN”
  • “deploy my VPN”
  • “set up VPN”
  • “/vpn-deploy”

Requirements

  • Python 3
  • A credential in VPN_SSH_KEY

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Environment Setup
  2. Dependency Check
  3. Connectivity Test
  4. Deployment
  5. Post-Deploy Verification
  6. Client Setup Instructions

What it can do on your machine

Read from SKILL.md and the folder at commit 486bf50. 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

    Shell commands in SKILL.md call:

    • python
    • python3
    • pip

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

  • Network

    No URLs in SKILL.md. Its commands use pip, 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 these keys or tokens, usually read from environment variables:

    • VPN_SSH_KEY

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

Context cost

Vpn Deploy loads about 1.4k tokens when it runs. Until then it costs about 51 tokens; SKILL.md has 709 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:31
    **Goal:** Ensure `.env` file exists and is correctly filled.
  • NoteMentions a .env fileSKILL.md:33
    1. Check if `.env` file exists in project root
  • NoteMentions a .env fileSKILL.md:41
    - Create `.env` from `.env.example` with user's values
  • NoteMentions a .env fileSKILL.md:43
    - Read `.env` and verify `VPN_HOST` is set (not placeholder `<YOUR_VPS_IP>`)
  • NoteMentions a .env fileSKILL.md:46
    **Verification:** `.env` exists AND `VPN_HOST` contains a real IP address.
  • NoteMentions a .env fileSKILL.md:66
    blocks port 22 to foreign IPs). Update `.env` and retry
  • NoteMentions a .env fileSKILL.md:135
    - Never display raw credentials or `.env` contents in chat output

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from Sergei-thinker/vpn-setup at commit 486bf50, republished under its MIT licence (© Sergei-thinker). 709 words, ~1,353 tokens.

Download SKILL.mdSave it as .claude/skills/vpn-deploy/SKILL.md (or your agent's skills folder).
name
vpn-deploy
description
Guided VPN deployment wizard. Use when user says 'deploy VPN', 'deploy my VPN', 'set up VPN', 'install VPN'. Also use when opening the project for the first time and user wants to get started.

VPN Deployment Wizard

Управляемый деплой VPN-инфраструктуры для начинающих пользователей. Каждый шаг проверяется перед переходом к следующему.

When to Use

Use when the user wants to deploy a VPN:

  • "Deploy VPN", "deploy my VPN"
  • "Set up VPN", "install VPN"
  • "Help me get started"

The Iron Law

NO STEP WITHOUT VERIFICATION OF THE PREVIOUS STEP

Do not proceed to deployment if connectivity check failed. Do not claim success without running status check.

Workflow

Execute these phases IN ORDER. Do not skip phases.

Phase 1: Environment Setup

Goal: Ensure .env file exists and is correctly filled.

  1. Check if .env file exists in project root
  2. If NO:
    • Read .env.example to understand required fields
    • Ask user for VPS details (in Russian):
      • IP-адрес VPS (VPN_HOST)
      • SSH-порт (default 22, recommend 49152)
      • SSH-пользователь (default root)
      • SSH-ключ path OR пароль (VPN_SSH_KEY or VPN_SSH_PASS)
    • Create .env from .env.example with user's values
  3. If YES:
    • Read .env and verify VPN_HOST is set (not placeholder <YOUR_VPS_IP>)
    • If placeholder values remain, ask user to fill them

Verification: .env exists AND VPN_HOST contains a real IP address.

Phase 2: Dependency Check

Goal: Ensure Python 3 and paramiko are available.

  1. Run python --version or python3 --version
  2. If Python not found: tell user to install Python 3
  3. Run python -c "import paramiko; print(paramiko.__version__)"
  4. If paramiko not found: run pip install paramiko scp

Verification: Both Python 3 and paramiko import successfully.

Phase 3: Connectivity Test

Goal: Verify SSH access to VPS.

  1. Run python ssh_exec.py status
  2. Interpret output:
    • Success: xray status shown, uptime visible -> proceed
    • "Connection refused": Port might be blocked. If port is 22, suggest trying 49152 (TSPU blocks port 22 to foreign IPs). Update .env and retry
    • "Authentication failed": Wrong password or SSH key. Ask user to verify credentials
    • "Connection timed out": VPS might be down or IP wrong. Ask user to verify VPS is running
    • "Host key verification failed": First connection to this server. Ask user to confirm the IP is correct, then suggest removing old known_hosts entry if IP was reused

Verification: ssh_exec.py status returns xray status or server info without errors.

Special case — fresh VPS (xray not installed yet): If SSH connects but xray is not found, that's EXPECTED for first-time deployment. Proceed to Phase 4.

Phase 4: Deployment

Goal: Deploy VPN infrastructure on the VPS.

  1. Inform user: "Starting deployment. This takes 15-20 minutes. The script will install 3X-UI panel, create VLESS Reality connections, configure firewall and monitoring."
  2. Run python ssh_exec.py deploy quick-rebuild.sh
  3. Monitor output for:
    • VLESS URIs (lines starting with vless://) — SAVE ALL OF THEM
    • Error messages — if script fails, check the last error message
    • Credentials (panel URL, username, password) — note these for user
  4. If deployment fails:
    • Read error output
    • Common issues: disk space, network timeout during package install, port conflict
    • Suggest: python ssh_exec.py restart then retry deployment

Verification: Script completes without errors AND outputs at least one VLESS URI.

Show full SKILL.md (237 more words)Show less
Phase 5: Post-Deploy Verification

Goal: Confirm VPN is actually running.

  1. Run python ssh_exec.py status
  2. Verify:
    • xray process is "running"
    • At least one inbound is active
    • Server uptime is fresh (just deployed)
  3. If xray is not running: python ssh_exec.py restart, then check again

Verification: ssh_exec.py status shows xray running with active inbounds.

Phase 6: Client Setup Instructions

Goal: Give user everything needed to connect.

Based on user's platform, provide:

Windows (v2rayN — recommended):

  1. Present all VLESS URIs from deployment output
  2. Point to client-configs/v2rayn-setup.md for detailed setup
  3. Key points:
    • Import URI via clipboard
    • Enable TUN mode (critical — without it, DNS and UDP leak)
    • Select split routing preset "RUv1" (Russian sites bypass VPN)
    • Use sing-box core for best compatibility

iOS (Shadowrocket — recommended):

  1. Present VLESS URIs
  2. Point to docs/04-client-setup.md iOS section
  3. Key: copy URI -> open Shadowrocket -> auto-imports

Android (v2rayNG):

  1. Present VLESS URIs
  2. Point to docs/04-client-setup.md Android section

Verification (user does this manually):

  • Tell user: "After connecting, open 2ip.ru in your browser. It should show your VPS country (Sweden/Netherlands/etc), NOT Russia. For Russian sites (yandex.ru, vk.com), it should show Russia."

Communication Rules

  • Communicate with user in Russian (per CLAUDE.md)
  • Never display raw credentials or .env contents in chat output
  • Present VLESS URIs clearly — user needs to copy them
  • If something fails, explain in simple terms what happened and what to try next
  • Do not overwhelm beginner with technical details — keep explanations concise

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

Files

Just SKILL.md in .claude/skills/vpn-deploy of Sergei-thinker/vpn-setup.

Open the folder on GitHubat commit 486bf50

Compare with similar skills

Vpn Deploy 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.

Vpn Deploy compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Vpn Deploy this skillSergei-thinker/vpn-setup189—~1.4kAutomated safety check: NotesMIT
AWS Cdk Developmentzxkane/aws-skills3672 repos~2.5kAutomated safety check: PassMIT
Azure Architecture Autopilotgithub/awesome-copilot40k1 repos~1.9kAutomated safety check: PassMIT
Blocks Networkblocksnetwork/blocks-sdk146—~2.3kAutomated safety check: NotesProprietary
DDNS Build and Release MaintenanceNewFuture/DDNS4.7k—~444Automated safety check: PassMIT
Generate Ors Envadithya-s-k/FineEnvs456—~2.3kAutomated safety check: NotesApache-2.0

Similar skills

  • 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

  • Azure Architecture Autopilot

    github/awesome-copilot

    Official

    Designs Azure infrastructure from a natural-language description, or diagrams an existing resource group, then refines the design through conversation and deploys it with Bicep.

    40k GitHub starsUsed in 1 repo~1.9k tokens
    DevOps & CloudAuto-check passed

  • Blocks Network

    blocksnetwork/blocks-sdk

    Modify, validate, run, register, publish, consume, and troubleshoot agents on Blocks Network.

    146 GitHub stars~2.3k tokensUpdated yesterday
    DevOps & CloudAuto-check: notes

  • DDNS Build and Release Maintenance

    NewFuture/DDNS

    Maintains the DDNS project's GitHub Actions, Docker and Nuitka builds, packaging and release preparation without touching publishing credentials.

    4.7k GitHub stars~444 tokensUpdated yesterday
    DevOps & CloudAuto-check passed

  • Generate Ors Env

    adithya-s-k/FineEnvs

    Builds an Open Reward Standard (ORS) variant of an RL environment using the official openreward Python package.

    456 GitHub stars~2.3k tokensUpdated yesterday
    DevOps & CloudAuto-check: notes

  • Google Agents CLI Deploy

    pifferologo/cloud-agents-cli

    This skill should be used when the user wants to "deploy an agent", "deploy my ADK agent", "set up CI/CD", "configure secrets", "troubleshoot a deployment", or needs guidance on Agent Runtime, Cloud…

    129 GitHub starsUsed in 1 repo~6k tokens
    DevOps & CloudAuto-check passed

More from Sergei-thinker/vpn-setup

  • Vpn Security Check

    Sergei-thinker/vpn-setup

    Infrastructure security audit for VPN server. An agent skill from Sergei-thinker/vpn-setup.

    189 GitHub stars~1.5k tokensUpdated 5 mo ago
    Auto-check: notes

  • Vpn Troubleshoot

    Sergei-thinker/vpn-setup

    VPN troubleshooting decision tree. An agent skill from Sergei-thinker/vpn-setup.

    189 GitHub stars~2.2k tokensUpdated 5 mo ago
    Auto-check: notes

  • Vpn Verify

    Sergei-thinker/vpn-setup

    Post-deployment verification checklist for VPN. An agent skill from Sergei-thinker/vpn-setup.

    189 GitHub stars~1k tokensUpdated 5 mo ago
    Auto-check: notes

Works with

Categories

Questions about Vpn Deploy

What does Vpn Deploy do?

Guided VPN deployment wizard. An agent skill from Sergei-thinker/vpn-setup. Vpn Deploy is an agent skill from Sergei-thinker/vpn-setup. Guided VPN deployment wizard.

When should I use Vpn Deploy?

Vpn Deploy fits situations like: user says deploy VPN; opening the project for the first time and user wants to get started.

How do I install Vpn Deploy in Claude Code?

Run `npx skills add Sergei-thinker/vpn-setup --skill vpn-deploy -a claude-code`. Or copy the skill folder (.claude/skills/vpn-deploy in Sergei-thinker/vpn-setup) into .claude/skills/vpn-deploy in your project. Claude Code loads it when a task matches its description.

How do I install Vpn Deploy in Codex?

Run `npx skills add Sergei-thinker/vpn-setup --skill vpn-deploy -a codex`. Or copy the skill folder (.claude/skills/vpn-deploy in Sergei-thinker/vpn-setup) into .agents/skills/vpn-deploy in your project. Codex loads it when a task matches its description.

Can I use Vpn Deploy 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 Sergei-thinker/vpn-setup --skill vpn-deploy -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/vpn-deploy, .gemini/skills/vpn-deploy, .github/skills/vpn-deploy and .opencode/skills/vpn-deploy in your project.

What does Vpn Deploy need to run?

Going by SKILL.md and its folder, Vpn Deploy needs the command-line tools its instructions call (python, python3 and pip) and credentials named VPN_SSH_KEY. Our summary lists: Python 3; A credential in VPN_SSH_KEY.

Does Vpn Deploy access the network?

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

Is Vpn Deploy safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Vpn Deploy use?

Vpn Deploy is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Vpn Deploy use?

About 1.4k tokens (SKILL.md is roughly 5.4k 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 Vpn Deploy?

Skills that share tags, products or a category with Vpn Deploy: AWS Cdk Development (zxkane/aws-skills, 367 stars), Azure Architecture Autopilot (github/awesome-copilot, 40k stars), Blocks Network (blocksnetwork/blocks-sdk, 146 stars) and DDNS Build and Release Maintenance (NewFuture/DDNS, 4.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Vpn Deploy?

Sergei-thinker (a GitHub user) maintains it in Sergei-thinker/vpn-setup, which has 189 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on April 17, 2026.

Source: Sergei-thinker/vpn-setup on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.