A guided wizard for deploying a VPN, which creates a private encrypted connection between a device and a remote server.

Use it to prepare configuration, collect VPS details, connect to the server, and verify the VPN deployment status.

It breaks deployment into checked steps and prevents later setup from continuing when an earlier connection or configuration check fails.

How Sergei-thinker/vpn-setup configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to Sergei-thinker/vpn-setup. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/Sergei-thinker/vpn-setup/master/.claude/skills/vpn-deploy/SKILL.md

Clone the repo

git clone --depth 1 https://github.com/Sergei-thinker/vpn-setup

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/sergei-thinker/vpn-setup/vpn-deploy.svg)](https://agentmods.dev/skills/sergei-thinker/vpn-setup/vpn-deploy)

Your own site

<a href="https://agentmods.dev/skills/sergei-thinker/vpn-setup/vpn-deploy"><img src="https://agentmods.dev/badge/skills/sergei-thinker/vpn-setup/vpn-deploy.svg" alt="Measured on agentmods" height="20"></a>

Per session 49 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,347 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00049	$0.01347
Opus 5	$0.00024	$0.00674
Sonnet 5	$0.00010	$0.00269
Haiku 4.5	$0.00005	$0.00135

Measured 8d ago against content hash fa70f4367ccd, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

vpn-deploy scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/vpn-deploy/SKILL.md · 139 lines

How it starts

The opening of the file, as written. The whole thing — 139 lines — stays where its author put it; the contents beside it link to each section on GitHub.

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.

Check if .env file exists in project root
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
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.

Run python --version or python3 --version
If Python not found: tell user to install Python 3
Run python -c "import paramiko; print(paramiko.__version__)"
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.

Run python ssh_exec.py status
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

Read the full file on GitHub · 139 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

8d ago First seen · 139 lines · 49 tokens per session scan A fa70f4367ccd

Subscribe to this mod's changes

vpn-deploy is a skill published in the GitHub repository Sergei-thinker/vpn-setup (182 stars, last pushed 4mo ago), licensed MIT. It adds 49 tokens to every session and 1,347 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Claude Code DevOps and cloud Security anti-censorship censorship reality russia vless

Xrayebator: your own VPN on a VPS (Xray Reality)

Use when the user needs their own VPN/proxy on a VPS to bypass regional blocks or DPI so research APIs and browsers work through a clean exit. One-script Xray VLESS+REALITY installer and client manager.

howdeploy/deploychan_mcp · 60 tokens

identity-work

A guided reflection skill for recognising when personal labels or fixed positions are distorting judgement, then using a new self-image to support behaviour change.

kangarooking/cangjie-skill · 126 tokens

mpstats-connector

A connector for MPStats, a paid analytics service for Ozon and Wildberries marketplace products. It reports sales, prices, stock, warehouses, and seller or brand details for specific items.

Vladimir-Human/ru-marketplace-mcp · 126 tokens

citilink-connector

A connector for searching Citilink and reading individual electronics product cards. Citilink is an electronics retailer, and the connector reads its rendered pages through an operator-controlled Chrome browser.

Vladimir-Human/ru-marketplace-mcp · 75 tokens

compare-prices

Use this skill when the operator asks where something is cheapest across marketplaces. Fans out to ten searchable sources — Wildberries, Ozon, Yandex Market, Avito, Taobao, Megamarket, Lamoda, DNS, Citilink and AliExpress (Detsky Mir is excluded — no text search; Taobao is ranked in yuan, never against rubles).…

Vladimir-Human/ru-marketplace-mcp · 132 tokens

aliexpress-connector

Use this skill when the operator asks to search AliExpress or read one of its product cards. Two tools, aliexpresssearch and aliexpresscard; prices in rubles; rating and order counts included, review TEXTS intentionally not exposed. CDP-only: without the scraping-profile Chrome this source answers nothing. Trigger on…

Vladimir-Human/ru-marketplace-mcp · 0 tokens

vpn-setup: Skill for Claude Code