smithery.ai

proxmox-infrastructure

Manage the Matrix/Virgo-Core Proxmox VE cluster (nodes Foxtrot, Golf, Hotel - MINISFORUM MS-A2 with AMD Ryzen 9 9955HX).

First seen Mar 17, 2026

Installation

$ npx skills add https://smithery.ai

View on skills.sh ↗ Website ↗

Summary

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).

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

import-infrastructure-as-code Similar name

github/awesome-copilot

Import existing Azure resources into Terraform using Azure CLI discovery and Azure Verified Mod…

6.9K installs

physical-ai-infrastructure-setup-and-resilient-scaling Similar name

nvidia/skills

>- Use when the user wants to set up, scale, validate, or harden NVIDIA physical AI infrastruct…

1.9K installs

extension-core-infrastructure Similar name

caffeinelabs/skills

Core infrastructure providing backend connection configuration, storage client, and React app e…

18.5K installs

infrastructure Similar name

grafana/skills

Ship Kubernetes, host, container, and cloud-provider telemetry into Grafana Cloud — `k8s-monito…

2.9K installs

platform-infrastructure Similar name

refoundai/lenny-skills

Help users build and scale internal platforms and technical infrastructure. Use when someone is…

1.6K installs

terraform-infrastructure Similar name

aj-geddes/useful-ai-prompts

Infrastructure as Code using Terraform with modular components, state management, and multi-clo…

618 installs

Also in this package

Other skills from smithery.ai · top by installs.

npx skills add https://smithery.ai

smithery-ai-cli 7.8K frontend-design 6.2K skill-creator 2.5K ck:ui-ux-pro-max 1.3K pdf 1.2K xlsx 966 pptx 894 docx 884 webapp-testing 1 web-design-reviewer 657

Browse all from smithery.ai

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared

Cursor Not declared

Codex Not declared

GitHub Copilot Not declared

Windsurf Not declared

Gemini CLI Not declared

Cline Not declared

OpenCode Not declared

Package contents

Files included with this skill beyond the listing page.

skill md SKILL.md 3,076 B
docs SUMMARY.md 314 B

History

Mar 17, 2026 First seen on skills.sh
Sep 9, 2026 First recorded snapshot · 3 installs

SKILL.md

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
checkcephhealth.py - CEPH storage pool health monitoring
checkclusterhealth.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

npx skills add https://smithery.ai