terraform-hcloud-kube-hetzner: Skill for Claude Code

.claude/skills/migrate-v2-to-v3/SKILL.md

migrate-v2-to-v3 is a skill for Claude Code from mysticaltech/terraform-hcloud-kube-hetzner. It costs 29 tokens per session (4,001 once invoked), scanned E, original, MIT.

A guide for moving an existing kube-hetzner Terraform setup from version 2 to version 3. Terraform is a tool for describing and changing cloud infrastructure with configuration files.

In plain words
What is it for?
It helps map old settings to new ones, validate the setup, review Terraform plans, back up state, and inspect upgrade or cleanup risks for an existing Kubernetes cluster.
Why use it?
Version changes can require renamed settings and may alter or replace real infrastructure. The guide helps check the configuration and plan while protecting the existing cluster.

Skill for Claude Code

Written for Claude Code: installed under .claude/.

This is mysticaltech/terraform-hcloud-kube-hetzner's own configuration. It tells Claude Code how to work on terraform-hcloud-kube-hetzner itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything terraform-hcloud-kube-hetzner configures →

About the project

Kube-Hetzner is an infrastructure project that uses Terraform or OpenTofu to deploy and maintain Kubernetes clusters on Hetzner Cloud. It is for operators who need highly available clusters based on k3s or RKE2, with networking, storage, ingress, certificates, and upgrades configured as part of the deployment.

mysticaltech/terraform-hcloud-kube-hetzner · 3,929 stars · on GitHub

Reuse

Borrowing it

Nothing to install: this file belongs to mysticaltech/terraform-hcloud-kube-hetzner. 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/mysticaltech/terraform-hcloud-kube-hetzner/master/.claude/skills/migrate-v2-to-v3/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/mysticaltech/terraform-hcloud-kube-hetzner

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.

agentmods badge for migrate-v2-to-v3

README.md
[![agentmods](https://agentmods.dev/badge/skills/mysticaltech/terraform-hcloud-kube-hetzner/migrate-v2-to-v3/github.svg)](https://agentmods.dev/skills/mysticaltech/terraform-hcloud-kube-hetzner/migrate-v2-to-v3)
Your own site
<a href="https://agentmods.dev/skills/mysticaltech/terraform-hcloud-kube-hetzner/migrate-v2-to-v3"><img src="https://agentmods.dev/badge/skills/mysticaltech/terraform-hcloud-kube-hetzner/migrate-v2-to-v3/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for migrate-v2-to-v3

Your own site · 80×15
<a href="https://agentmods.dev/skills/mysticaltech/terraform-hcloud-kube-hetzner/migrate-v2-to-v3"><img src="https://agentmods.dev/badge/skills/mysticaltech/terraform-hcloud-kube-hetzner/migrate-v2-to-v3.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 29 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,001 The whole file, excluding the scripts and references it only reads on demand.
Security scan E 2 findings. A grade says what 26 rules found in the file — not that it is safe. ✓ AI security review Sonnet 5 · 7 Sept 2026 📄 Read the review
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.1 $0.00029 $0.04001
Opus 5 $0.00015 $0.02001
Sonnet 5 $0.00006 $0.00800
Haiku 4.5 $0.00003 $0.00400

Measured 2d ago against content hash 091014650d57, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade E, and why

migrate-v2-to-v3 scanned grade E with 2 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 2d 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.

Reaches for credential fileshighPrivilege escalation

SSH keys, cloud credentials, git-credentials, .npmrc, /etc/shadow: reading these is how a config file becomes a credential leak.

`/root/.ssh/authorized_keys`. The default preserves unknown out-of-band keys

Recursive force deletehighDestructive command

rm -rf with a variable or a broad path is one typo away from removing the wrong tree.

rm -rf "$tmpdir"
.claude/skills/migrate-v2-to-v3/SKILL.md · 346 lines

How it starts

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

Migrate kube-hetzner v2 to v3

Purpose

Safely migrate an existing kube-hetzner cluster from v2.x to v3.x.

This skill is for real user Terraform roots, not for brand-new clusters. It prioritizes preserving infrastructure and making Terraform validation failures actionable.

Canonical References

Read these before editing:

  1. docs/v2-to-v3-migration.md - operational migration playbook
  2. docs/v3-release-evidence.md - live v2.21 -> v3 upgrade evidence
  3. MIGRATION.md - canonical old-to-new variable map
  4. CHANGELOG.md - v3 upgrade notes and release context
  5. variables.tf - exact v3 input contract and validation rules
  6. kube.tf.example - current v3 configuration example
  7. scripts/v2_to_v3_migration_assistant.py - static config and plan audit
  8. docs/selinux.md - SELinux policy, AVC evidence, and per-pool fallback
  9. scripts/destroy.sh and scripts/cleanup.sh - teardown and orphan cleanup

Safety Rules

  • Never run terraform apply unless the user explicitly asks after plan review.
  • Always back up state before changing the module version.
  • Never ignore destroy, replace, or forces replacement in a v3 upgrade plan.
  • Do not allow a silent K3s channel policy change. MIGRATION.md documents that v2 defaulted k3s_channel to v1.33; v3 defaults it to stable while automatic Kubernetes upgrades remain default-on. The user must choose before the first v3 apply.
  • Treat replacements for hcloud_network, hcloud_network_subnet, hcloud_server, hcloud_load_balancer, hcloud_primary_ip, hcloud_placement_group, hcloud_volume, or hcloud_firewall as blockers until explained.
  • For production in-place upgrades, MIGRATION.md is the operator-facing safety contract. Its no-destroy jq gate is canonical; do not weaken or abbreviate it.
  • Never reorder or insert control-plane or agent nodepools mid-list during or after migration. Node resource addresses are index-keyed; append only unless the user is intentionally planning a state migration or blue/green rebuild.
  • Do not "fix" a v3 validation error by bypassing validation. Fix the configuration.
  • For custom network, private-only, Robot/vSwitch, or multinetwork clusters, prefer recommending blue/green if the in-place plan is not clearly safe.

Read the full file on GitHub · 346 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.

  1. 2d ago Changed · +6 lines 091014650d57
  2. 10d ago Changed · +2 lines 3d0312ef7bcf
  3. 13d ago First seen · 338 lines · 29 tokens per session scan E 125b0b7a3891

Subscribe to this mod's changes

migrate-v2-to-v3 is a skill published in the GitHub repository mysticaltech/terraform-hcloud-kube-hetzner (3,929 stars, last pushed 3d ago), licensed MIT. It adds 29 tokens to every session and 4,001 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it E with 2 findings (reaches for credential files, recursive force delete). 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

k8s-aiops

Use this skill whenever the user needs to operate a Kubernetes cluster — list/inspect pods, deployments, statefulsets, daemonsets, replicasets, jobs, cronjobs, services, ingresses, endpoints, configmaps, secrets (names/keys only), PVCs/PVs/storageclasses, nodes, namespaces, and events; read pod logs; describe…

AIops-tools/K8s-AIops · 308 tokens

k8s-network-policy

Review Kubernetes NetworkPolicies — what is actually permitted to reach a workload, and whether the answer can be trusted. Use when asked what can talk to a pod, whether a namespace is restricted, why traffic is being blocked, or for any security review of cluster network segmentation.

automateyournetwork/netclaw · 60 tokens

k8s-service-path

Trace the Kubernetes service path — Service to selector to pods to EndpointSlices to readiness, plus Ingress routing. Use when a service is getting no traffic, an ingress is not routing, or someone asks why a workload is unreachable inside a cluster.

automateyournetwork/netclaw · 55 tokens

k8s-workload-inventory

List Kubernetes workloads and namespaces — pods with their node, phase and readiness, plus events. Use when asked what is running, where it is running, what is failing, or for a general inventory of a cluster.

automateyournetwork/netclaw · 51 tokens

Cloud Security & Container Hardening

AWS/Azure/GCP security auditing, container and Kubernetes hardening, Infrastructure as Code scanning, and cloud compliance assessment.

Masriyan/Claude-Code-CyberSecurity-Skill · 30 tokens

huawei-cloud-solution-ops

A skill for Huawei Cloud solution operations. It helps agents inspect, plan, operate, troubleshoot, and verify Huawei Cloud resources through hcloud, Huawei Cloud SDKs, Terraform, and MaaS capabilities. Use this when users want to query or change Huawei Cloud resources, troubleshoot authentication and API issues…

huaweicloud/huaweicloud-skills · 81 tokens