How do I install the Hetzner Vnc Screenshot skill?

Run npx skillmds@latest add majiayu000/hetzner-vnc-screenshot in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Hetzner Vnc Screenshot skill do?

Take and view screenshots of Hetzner Cloud servers via WebSocket VNC console It is listed under DevOps & Infra on SkillMD.

Is Hetzner Vnc Screenshot safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Hetzner Vnc Screenshot?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Hetzner Vnc Screenshot free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Hetzner Vnc Screenshot?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Hetzner Vnc Screenshot by majiayu000

Name: Hetzner Vnc Screenshot
Rating: 4.2 (5 reviews)
Author: majiayu000

File contents

Hetzner VNC Screenshot Skill

This skill captures screenshots of Hetzner Cloud servers by connecting to the WebSocket-based VNC console.

Instructions

When asked to take a screenshot or view the console of a Hetzner Cloud server:

Option 1: By Server Name (Recommended)

Requires HCLOUD_TOKEN environment variable:

uv run ~/.claude/skills/hetzner-vnc-screenshot/vnc-screenshot.py my-server-name --output /tmp/screenshot.png

Option 2: With Explicit Credentials

If you already have the WebSocket URL and password:

uv run ~/.claude/skills/hetzner-vnc-screenshot/vnc-screenshot.py --url '<wss_url>' --password '<password>' --output /tmp/screenshot.png

Step 2: View Screenshot

Use the Read tool to view /tmp/screenshot.png

Examples

Taking screenshot of server "talos-vps-0":

# One command (uses HCLOUD_TOKEN from environment)
uv run ~/.claude/skills/hetzner-vnc-screenshot/vnc-screenshot.py talos-vps-0 --output /tmp/talos-vps-0.png

Then use Read tool to view /tmp/talos-vps-0.png

With custom API token:

uv run ~/.claude/skills/hetzner-vnc-screenshot/vnc-screenshot.py talos-vps-0 --token <api-token> --output /tmp/screenshot.png

CLI Options

Arguments:
  server          Server name (requires HCLOUD_TOKEN env var)

Options:
  --url           WebSocket URL (alternative to server name)
  --password      VNC password (required with --url)
  --token         Hetzner API token (default: HCLOUD_TOKEN env)
  --output        Output image path (default: screenshot.png)

Use Cases

Debugging Talos Linux boot issues
Viewing console output when network is unreachable
Checking boot progress, kernel messages
Diagnosing servers stuck in maintenance mode
Viewing GRUB menu or BIOS/UEFI screens

Technical Details

Connects via secure WebSocket (wss://)
Uses asyncvnc library for RFB (VNC) protocol
Supports VNC password authentication
Captures framebuffer and saves as PNG
Dependencies auto-installed by uv: asyncvnc, pillow, typer, hcloud, websockets

Notes

Requires hcloud CLI or HCLOUD_TOKEN environment variable
Console credentials are fetched automatically when using server name
Works with any Hetzner Cloud server (not just Talos)
Screen resolution is determined by the server's console settings

---name: hetzner-vnc-screenshotdescription: Take and view screenshots of Hetzner Cloud servers via WebSocket VNC console--- # Hetzner VNC Screenshot Skill This skill captures screenshots of Hetzner Cloud servers by connecting to the WebSocket-based VNC console. ## Instructions When asked to take a screenshot or view the console of a Hetzner Cloud server: ### Option 1: By Server Name (Recommended) Requires `HCLOUD_TOKEN` environment variable: ```bash uv run ~/.claude/skills/hetzner-vnc-screenshot/vnc-screenshot.py my-server-name --output /tmp/screenshot.png ``` ### Option 2: With Explicit Credentials If you already have the WebSocket URL and password: ```bash uv run ~/.claude/skills/hetzner-vnc-screenshot/vnc-screenshot.py --url '<wss_url>' --password '<password>' --output /tmp/screenshot.png ``` ### Step 2: View Screenshot Use the Read tool to view `/tmp/screenshot.png` ## Examples **Taking screenshot of server "talos-vps-0":** ```bash # One command (uses HCLOUD_TOKEN from environment) uv run ~/.claude/skills/hetzner-vnc-screenshot/vnc-screenshot.py talos-vps-0 --output /tmp/talos-vps-0.png ``` Then use Read tool to view `/tmp/talos-vps-0.png` **With custom API token:** ```bash uv run ~/.claude/skills/hetzner-vnc-screenshot/vnc-screenshot.py talos-vps-0 --token <api-token> --output /tmp/screenshot.png ``` ## CLI Options ``` Arguments: server Server name (requires HCLOUD_TOKEN env var) Options: --url WebSocket URL (alternative to server name) --password VNC password (required with --url) --token Hetzner API token (default: HCLOUD_TOKEN env) --output Output image path (default: screenshot.png) ``` ## Use Cases - Debugging Talos Linux boot issues - Viewing console output when network is unreachable - Checking boot progress, kernel messages - Diagnosing servers stuck in maintenance mode - Viewing GRUB menu or BIOS/UEFI screens ## Technical Details - Connects via secure WebSocket (wss://) - Uses asyncvnc library for RFB (VNC) protocol - Supports VNC password authentication - Captures framebuffer and saves as PNG - Dependencies auto-installed by uv: asyncvnc, pillow, typer, hcloud, websockets ## Notes - Requires `hcloud` CLI or `HCLOUD_TOKEN` environment variable - Console credentials are fetched automatically when using server name - Works with any Hetzner Cloud server (not just Talos) - Screen resolution is determined by the server's console settings

Frequently asked questions

Hetzner Vnc Screenshot