proxmox

Name: proxmox
Author: poindexter12

github.com/poindexter12Cloud & DevOps736 installsUpdated 40w ago

About proxmox

proxmox is a reference skill for the Proxmox VE virtualization platform, covering VM, container, cluster, and homelab infrastructure management. It provides topic-specific references, command guidance, and a pre-deployment checklist.

Key features

01VM and LXC management reference
02Networking, storage, and clustering guides
03Cloud-init and backup references
04Guidance for common CLI tools
05Pre-deployment validation checklist

Use cases

01Choose between VM and LXC virtualization
02Configure network bridges, VLANs, or storage
03Plan cluster high availability and backups
04Check node and resource status before deployment

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/poindexter12/waypoint --skill proxmox

After installing, type/proxmoxin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/

automation-tools.md

backup.md

cli-tools.md

cloud-init-templates.md

clustering.md

docker-hosting.md

networking.md

storage.md

troubleshooting.md

vm-lxc.md

Details

From the project README

Proxmox Skill

Proxmox VE virtualization platform reference for VM management, containers, clustering, and homelab infrastructure.

Quick Reference

# VM management (qm)
qm list                           # List all VMs
qm status <vmid>                  # Check VM status
qm start <vmid>                   # Start VM
qm stop <vmid>                    # Stop VM (graceful)
qm shutdown <vmid>                # Shutdown VM (ACPI)
qm unlock <vmid>                  # Remove lock
qm config <vmid>                  # Show VM config

# Container management (pct)
pct list                          # List all containers
pct status <ctid>                 # Check container status
pct start <ctid>                  # Start container
pct stop <ctid>                   # Stop container
pct enter <ctid>                  # Enter container shell

# Cluster management (pvecm)
pvecm status                      # Cluster status and quorum
pvecm nodes                       # List cluster nodes

# API shell (pvesh)
pvesh get /nodes                  # List nodes via API
pvesh get /nodes/<node>/status    # Node resource status

# Backup (vzdump)
vzdump <vmid> --mode snapshot --storage <storage>
vzdump --all --compress zstd

Reference Files

Load on-demand based on task:

Topic	File	When to Load
VM vs LXC	vm-lxc.md	Choosing virtualization type
Docker Hosting	docker-hosting.md	Running Docker on Proxmox
Networking	networking.md	Bridges, VLANs, SDN, firewall
Storage	storage.md	Storage backends, content types
Cloud-init	cloud-init-templates.md	VM provisioning with cloud-init
Clustering	clustering.md	HA, quorum, fencing
Backup	backup.md	vzdump modes, restore
CLI Tools	cli-tools.md	qm, pct, pvecm, pvesh commands
Troubleshooting	troubleshooting.md	Common errors, diagnostics
Automation Tools	automation-tools.md	Terraform/Ansible integration

Validation Checklist

Before deploying VMs/containers:

Cluster status healthy (pvecm status)
Node resources available (CPU, RAM, disk)
Storage accessible and mounted
Network bridges configured correctly
VLAN tags match network design
Resource allocation within node limits
HA configuration correct (if enabled)
Backup schedule in place
Naming convention followed

VM vs LXC Quick Decision

Factor	Use VM	Use LXC
OS	Windows, BSD, any	Linux only
Isolation	Full kernel isolation	Shared kernel
Performance	Good	Better (lighter)
Startup	Slower	Fast
Density	Lower	Higher
Complexity	Any workload	Simple services

Homelab Network VLANs

VLAN	Purpose	Proxmox Bridge
5	Management (Web UI, API, SSH)	vmbr5
1	Trusted network	vmbr0
11	Storage (NFS/Ceph, MTU 9000)	vmbr11
12	High-speed transfers	vmbr12

Comments

Markdown supported

Details

Author: poindexter12
Repository: poindexter12/waypoint
Category: Cloud & DevOps
Installs: 36
GitHub stars: 7

Report

More skills

All skills

lark-apps

open.feishu.cn

732.0k

Develop and host Miaoda (Spark/Miaoda) apps: app creation, local full-stack development, cloud generation and iteration, creative design (UI mockups / interactive prototypes / wireframes / landing pages / dashboards / slide decks / visual exploration), integration of AI-related capabilities, Feishu platform capabilities, or other external capabilities; log/Trace/monitoring metric/PV/UV queries; environment variable management; app collaborators and collaboration permissions; app roles and members; and automation triggers (scheduled / record changes / Webhook / Feishu approvals). Use when users want to develop or create a system, tool, platform, or app; develop locally or in the cloud, modify, deploy, publish, launch, or get a shareable link; create a page or website with HTML and deploy it to Miaoda; design, create a mockup, prototype, wireframe, PPT, deck, or visual exploration; or mention Miaoda/Spark/Miaoda apps (links like `/app/app_xxx` or `/page/<token>`, runtime domains like *.aiforce.cloud), app databases, app file storage, open API Keys, visibility, app collaborators/developer permissions, app roles/role members, production logs, API request volume, error volume, latency, traffic, environment variables, or setting up automation tasks, scheduled triggers, or approval-triggered automation for Miaoda apps. Not for regular cloud drive file uploads (lark-drive), Feishu document editing (lark-doc), or native slide creation (lark-slides).

azure-prepare

github.com/microsoft

571.7k

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow. USE ONLY when the user explicitly wants to use azd as the deployment tool, or the project already has an azure.yaml file. DO NOT USE FOR: non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migration (use azure-cloud-migrate). WHEN: prepare app for azd, create azure.yaml, set up azd infrastructure, modernize app for Azure with azd, deploy with azd, function app, timer trigger, service bus trigger, event-driven function, managed identity, generate Bicep, generate Terraform, create and deploy to Azure.

wizard

github.com/mattpocock

571.5k

Generate an interactive bash wizard that walks a human through steps only they can perform. Use when provisioning infrastructure, setting up credentials or CI secrets, walking an unfamiliar third-party dashboard, or running a one-off migration or cutover. Don't invoke this for steps the agent can perform itself.

azure-ai

github.com/microsoft

571.2k

Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.