hetzner-cloud

hetzner-cloud is a skill for Claude Code, Codex from monkilabs/opencastle. It costs 94 tokens per session (1,876 once invoked), scanned C, original, MIT.

A guide for running Hetzner Cloud infrastructure, including servers, storage volumes, private networks, and firewalls. Hetzner Cloud is a service for renting and managing cloud servers.

In plain words
What is it for?
Use it when creating or resizing servers, attaching volumes, configuring private networks or firewalls, planning ARM servers, setting up backups, or preparing disaster recovery.
Why use it?
It helps plan compatible server sizes and locations, set up network protection, and make infrastructure repeatable with command-line or infrastructure-as-code tools. It also covers backups and rebuilding systems after failures.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/monkilabs/opencastle/hetzner
Any agent
npx skills add monkilabs/opencastle --skill hetzner
Clone the repo
git clone --depth 1 https://github.com/monkilabs/opencastle

Made for: Claude Code, Codex.

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.

agentmods badge for hetzner-cloud

README.md
[![agentmods](https://agentmods.dev/badge/skills/monkilabs/opencastle/hetzner.svg)](https://agentmods.dev/skills/monkilabs/opencastle/hetzner)
Your own site
<a href="https://agentmods.dev/skills/monkilabs/opencastle/hetzner"><img src="https://agentmods.dev/badge/skills/monkilabs/opencastle/hetzner.svg" alt="Measured on agentmods" height="20"></a>
Per session 94 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,876 The whole file, excluding the scripts and references it only reads on demand.
Security scan C 1 finding. Scan, not verified.
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.

ModelPer sessionOnce invoked
Fable 5 $0.00094 $0.01876
Opus 5 $0.00047 $0.00938
Sonnet 5 $0.00019 $0.00375
Haiku 4.5 $0.00009 $0.00188

Measured 3d ago against content hash e4ad8ae6865d, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade C, and why

hetzner-cloud scanned grade C with 1 finding 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 3d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (config.ts), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

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.

Cloud metadata endpointhighServer-side request forgery

One request to 169.254.169.254 can return temporary IAM credentials.

- Metadata endpoint: `http://169.254.169.254/hetzner/v1/metadata` (useful in cloud-init to self-discover private IP).
src/orchestrator/plugins/hetzner/SKILL.md · 97 lines

How it starts

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

Hetzner Cloud

Facts that drift (prices, SKUs, locations, limits) go stale — prefer retrieval over pre-training: hcloud server-type list -o json, hcloud location list, docs.hetzner.com. Everything below is behavior, not price sheets. If the project documents a topology (e.g. docs/architecture/), read it before provisioning anything.

Provisioning Workflow

  1. Pick type + location together — CAX (Ampere arm64, best RAM/€) exists only in EU DCs (fsn1/nbg1/hel1); verify with hcloud server-type list. arm64 requires multi-arch container images end-to-end.
    • Checkpoint: hcloud server-type describe <type> shows the target location.
  2. Create network + firewall before servers — attach at create time; firewall via label selector (role=web) scales better than per-server IDs.
    • Checkpoint: firewall rules list SSH restricted to admin IPs, never 0.0.0.0/0.
  3. Create server with cloud-init user-data — runs once at first boot only.
    • Recovery: broken cloud-init → don't patch by hand; fix the template, server rebuild (keeps IPs) or replace via IaC.
  4. Attach volumes, then mount explicitly — see Volumes below.
    • Checkpoint: mount survives reboot (fstab entry, not just automount).
  5. Enable protection on stateful resourceshcloud server enable-protection <s> delete rebuild + same for volumes.
    • Gate: protection verified via hcloud server describe before real data lands.

Non-Obvious Behaviors

Networking

  • Cloud Firewalls filter ONLY the public interface. Private-network traffic is never touched by them — segment the private net with host firewalls (ufw) or not at all. This is the most common Hetzner security misconception.
  • Private network MTU is 1450, not 1500 — override in Docker (daemon.json "mtu": 1450) and any overlay/VPN on top, or suffer silent large-packet stalls.
  • Private networks are not encrypted — treat as shared fabric, keep TLS for sensitive cross-node traffic.
  • Network zones (e.g. eu-central = fsn1/nbg1/hel1) span DCs — cross-DC private traffic works and is free.
  • Floating IPs need manual OS config (netplan alias); primary IPs configure themselves. Floating IP ≠ instant failover without host-side automation.
  • IPv4 primary IPs bill separately and survive server deletion unless auto_delete is set — orphaned IPs keep billing.

Read the full file on GitHub · 97 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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.

  1. 3d ago First seen · 97 lines · 94 tokens per session scan C e4ad8ae6865d

Subscribe to this mod's changes

hetzner-cloud is a skill published in the GitHub repository monkilabs/opencastle (61 stars, last pushed 5d ago), licensed MIT. It adds 94 tokens to every session and 1,876 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it C with 1 finding (cloud metadata endpoint). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

deploying-scalable-agents

Take a working agent prototype to a scalable, observable production deployment on Microsoft Foundry. Covers deployment patterns (client-hosted, hosted agents, agent workflows), the agent lifecycle, model routing, response caching, evaluation gates, human-in-the-loop approval, observability with OpenTelemetry, cost…

microsoft/ai-agents-for-beginners · 197 tokens

k8s-cost-visibility

Estimate Kubernetes infrastructure costs by querying cluster node, pod, PVC/PV, and LoadBalancer data, applying cloud pricing models, and producing cost attribution reports with storage and LoadBalancer cost tracking, grouped by namespace, workload, node, label, or annotation.

initializ/forge · 58 tokens

product-architect

Complete product development system with 64 agents and 35 frameworks. Use when the user wants to build a product, write a PRD, plan an MVP or roadmap, design an app, research a market or check whether a feature already exists or is novel, do competitive analysis, run a security audit, build a financial model, plan…

ankitjha67/product-architect · 211 tokens

codex-delegation

Use when a coding task would benefit from delegating work to Codex in the background — a deep independent second opinion, security or architecture analysis, or a parallel implementation running while the session continues. Lets Claude drive the codex companion itself (task, review, status --wait, result) without the…

zebbern/agent-collab · 74 tokens

cursor-delegation

Use when a coding task would benefit from delegating work to Cursor in the background — fast parallel implementation, scaffolding, or an everyday review running while the session continues. Lets Claude drive the cursor companion itself (task, review, status --wait, result) without the user typing /cursor: commands.

zebbern/agent-collab · 66 tokens

alibaba-live-ack-rollout-guard

Gate ACK deployment mutations, node pool scaling, and cluster version upgrades against rollback posture and workload disruption budget. Prevents irreversible cluster version upgrades from proceeding without PodDisruptionBudget verification, node drain confirmation, and explicit operator approval.

VincentChuWaiChow/vanguard-frontier-agentic · 55 tokens