How do I install the Proxmox Infrastructure skill?

Run npx skillmds@latest add basher83/proxmox-infrastructure 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.

Is Proxmox Infrastructure safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Proxmox Infrastructure?

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 Proxmox Infrastructure free to use?

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

Who published Proxmox Infrastructure?

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

Proxmox Infrastructure by basher83 — Agent Skill

Name: Proxmox Infrastructure
Rating: 4.5 (4 reviews)
Author: basher83

Proxmox Infrastructure

Manage the Matrix/Virgo-Core Proxmox VE cluster (nodes Foxtrot, Golf, Hotel - MINISFORUM MS-A2 with AMD Ryzen 9 9955HX). Covers VM provisioning, VLAN networking, CEPH storage, and automation via Python (proxmoxer), Ansible (community.general.proxmox), and Terraform (Telmate/proxmox).

basher83 4dc18b1 16 files · 138.8 KB Updated Sep 10, 2026

File contents

Proxmox Infrastructure: Matrix/Virgo-Core Cluster

Manage 3-node Proxmox VE cluster with CEPH storage, VLAN networking, and cloud-init automation.

Available Tools

Python Scripts (uv-based)

validate_template.py - Validate template health via Proxmox API
cluster_status.py - Cluster health metrics and node status
check_ceph_health.py - CEPH storage pool health monitoring
check_cluster_health.py - Comprehensive cluster diagnostics

All scripts support --help for usage. Run with: uv run tools/<script>.py

Automation Examples

Ansible playbooks - Template creation, VLAN bridging setup
Terraform modules - VM cloning, multi-node deployments with dual NICs

See examples/ and workflows/ for working configurations.

Core Capabilities

Template Management:

Ubuntu/Debian cloud-init templates with virtio-scsi
Serial console configuration for cloud images
Proper boot order and cloud-init CD-ROM (ide2)

Network Infrastructure:

vmbr0: Management (VLAN 9 for Corosync)
vmbr1: CEPH Public (192.168.5.0/24, MTU 9000)
vmbr2: CEPH Private (192.168.7.0/24, MTU 9000)
VLAN-aware bridging (supports VLANs 2-4094)
802.3ad LACP bonding

CEPH Storage:

Multi-OSD configuration (2× 4TB NVMe per node)
MTU 9000 for storage networks
Public/private network separation
Health monitoring and diagnostics

API Automation:

Python via proxmoxer library
Ansible via community.general.proxmox_* modules
Terraform via Telmate/proxmox provider

Cluster Architecture (Matrix)

Hardware: 3× MINISFORUM MS-A2

AMD Ryzen 9 9955HX (16C/32T)
64GB DDR5 @ 5600 MT/s
3× NVMe: 1× 1TB boot, 2× 4TB CEPH OSDs
4× NICs: 2× 10GbE SFP+, 2× 2.5GbE

Nodes: Foxtrot, Golf, Hotel

Quick Examples

Clone template to VM:

qm clone 9000 101 --name web-01
qm set 101 --ipconfig0 ip=192.168.3.100/24,gw=192.168.3.1
qm set 101 --net0 virtio,bridge=vmbr0,tag=30
qm start 101

Check cluster health:

uv run tools/cluster_status.py
uv run tools/check_ceph_health.py

For Details

reference/ - Cloud-init, networking, API, storage, QEMU guest agent
workflows/ - Cluster formation, CEPH deployment automation
examples/ - Terraform configs, Ansible playbooks
anti-patterns/ - Common mistakes from real deployments

---name: proxmox-infrastructuredescription: Manage the Matrix/Virgo-Core Proxmox VE cluster (nodes Foxtrot, Golf, Hotel - MINISFORUM MS-A2 with AMD Ryzen 9 9955HX). Covers VM provisioning, VLAN networking, CEPH storage, and automation via Python (proxmoxer), Ansible (community.general.proxmox), and Terraform (Telmate/proxmox).---# Proxmox Infrastructure: Matrix/Virgo-Core ClusterManage 3-node Proxmox VE cluster with CEPH storage, VLAN networking, and cloud-init automation.## Available Tools### Python Scripts (uv-based)- **validate_template.py** - Validate template health via Proxmox API- **cluster_status.py** - Cluster health metrics and node status- **check_ceph_health.py** - CEPH storage pool health monitoring- **check_cluster_health.py** - Comprehensive cluster diagnosticsAll scripts support `--help` for usage. Run with: `uv run tools/<script>.py`### Automation Examples- **Ansible playbooks** - Template creation, VLAN bridging setup- **Terraform modules** - VM cloning, multi-node deployments with dual NICsSee examples/ and workflows/ for working configurations.## Core Capabilities**Template Management:**- Ubuntu/Debian cloud-init templates with virtio-scsi- Serial console configuration for cloud images- Proper boot order and cloud-init CD-ROM (ide2)**Network Infrastructure:**- vmbr0: Management (VLAN 9 for Corosync)- vmbr1: CEPH Public (192.168.5.0/24, MTU 9000)- vmbr2: CEPH Private (192.168.7.0/24, MTU 9000)- VLAN-aware bridging (supports VLANs 2-4094)- 802.3ad LACP bonding**CEPH Storage:**- Multi-OSD configuration (2× 4TB NVMe per node)- MTU 9000 for storage networks- Public/private network separation- Health monitoring and diagnostics**API Automation:**- Python via proxmoxer library- Ansible via community.general.proxmox_* modules- Terraform via Telmate/proxmox provider## Cluster Architecture (Matrix)**Hardware:** 3× MINISFORUM MS-A2- AMD Ryzen 9 9955HX (16C/32T)- 64GB DDR5 @ 5600 MT/s- 3× NVMe: 1× 1TB boot, 2× 4TB CEPH OSDs- 4× NICs: 2× 10GbE SFP+, 2× 2.5GbE**Nodes:** Foxtrot, Golf, Hotel## Quick Examples**Clone template to VM:**```bashqm clone 9000 101 --name web-01qm set 101 --ipconfig0 ip=192.168.3.100/24,gw=192.168.3.1qm set 101 --net0 virtio,bridge=vmbr0,tag=30qm start 101```**Check cluster health:**```bashuv run tools/cluster_status.pyuv run tools/check_ceph_health.py```## For Details- **reference/** - Cloud-init, networking, API, storage, QEMU guest agent- **workflows/** - Cluster formation, CEPH deployment automation- **examples/** - Terraform configs, Ansible playbooks- **anti-patterns/** - Common mistakes from real deployments

Frequently asked questions