proxmox-k3s-infra
CommunityRebuild a K3s cluster and VMs deterministically.
System Documentation
What problem does it solve?
This Skill helps you set up and troubleshoot a Proxmox-based homelab Kubernetes (K3s) and VM/LXC infrastructure so nodes join correctly, GPU passthrough works, storage and backups are reliable, and the whole environment can be rebuilt reproducibly.
Core Features & Use Cases
- Proxmox + K3s deployment guidance: Choose VMs vs LXC correctly, size nodes for single-node or multi-node clusters, and install K3s using a repeatable approach.
- GPU passthrough validation and fixes: Apply the right IOMMU/vfio workflow and detect common issues like incorrect IOMMU grouping.
- Automation-ready infrastructure with guardrails: Use Terraform for declarative VM lifecycle, set up GitOps for cluster apps, and back up VMs/K3s (including restore confidence checks).
What problem does it solve?
Real-world example: you want to turn a fresh Proxmox host into a working K3s cluster with Longhorn storage for persistent workloads, configure GPU passthrough so workloads can use hardware acceleration, and then ensure everything can be rebuilt via templates and IaC without manual drift.
Quick Start
Ask for a step-by-step Proxmox + K3s plan that includes VM templates with cloud-init, node sizing, GPU passthrough checks, and a minimal GitOps bootstrap for persistent workloads.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: proxmox-k3s-infra Download link: https://github.com/drewid74/ai_skills/archive/main.zip#proxmox-k3s-infra Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.