proxmox — Claude Code skill: what it does, how to install
Proxmox VE reference guide for managing VMs and LXC containers, networking, cluster configurations, and backups.
MIT 1 installs ★ 7 updated 2026-01-20
npx skills add poindexter12/waypoint --skill proxmox -a claude-codeWhat proxmox does
This skill equips your coding agent with operational guidance for Proxmox VE environments. It outlines key CLI commands for qm, pct, pvecm, pvesh, and vzdump, along with pre-flight deployment checklists and container-versus-VM evaluation matrices.
The underlying references cover external provisioning patterns for Terraform and Ansible, cloud-init provisioning, Docker hosting setups, storage backends, and network bridge partitioning. Because this is purely a knowledge skill, executing actions on actual clusters requires your agent to have active CLI or API credentials on the host.
What it helps with
- look up CLI syntax for managing VMs with qm or LXC containers with pct
- evaluate whether to choose an LXC container or a VM for a service
- verify network bridges, VLANs, and node limits before provisioning
- structure vzdump backup commands and cloud-init templates
Example prompts for the agent
- Show me how to unlock and gracefully shut down VM 102 via Proxmox CLI
- Help configure a vzdump command to back up all nodes with zstd compression
- What bridge and VLAN setup should I use for isolated storage traffic in Proxmox?
How to install proxmox
1Skills CLI (Vercel)
npx skills add poindexter12/waypoint --skill proxmox -a claude-code2Manually: put the files in place
~/.claude/skills/proxmox/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/proxmox/
1Skills CLI (Vercel)
npx skills add poindexter12/waypoint --skill proxmox -a codex2Manually: put the files in place
.agents/skills/proxmox/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add poindexter12/waypoint --skill proxmox -a cursor2Manually: put the files in place
.cursor/skills/proxmox/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install poindexter12/waypoint technologies/skills/proxmox2Manually: put the files in place
.github/skills/proxmox/SKILL.md1Skills CLI (Vercel)
npx skills add poindexter12/waypoint --skill proxmox -a gemini-cli2Platform CLI
gemini skills install https://github.com/poindexter12/waypoint --path technologies/skills/proxmoxManually: put the files in place
.devin/skills/proxmox/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add poindexter12/waypoint --skill proxmox -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about proxmox
How to install proxmox in Claude Code?
Run npx skills add poindexter12/waypoint --skill proxmox -a claude-code in your terminal.
What does the proxmox skill do?
It gives the assistant structured documentation on Proxmox VE management, automation with Ansible or Terraform, network layouts, and error diagnostics.
Does this skill connect directly to my Proxmox cluster?
No, it functions as an operational reference manual. Any cluster interaction relies on the shell access and command privileges available to your agent.
Source text
SKILL.md · MIT
--- name: proxmox description: | Proxmox VE virtualization platform reference for VM/LXC management, clustering, storage, and networking. Includes Terraform and Ansible integration patterns. Use when working with Proxmox configurations, CLI commands, troubleshooting VMs/containers, or planning resource allocation. Triggers: proxmox, qemu, kvm, lxc, pve, vm, container, cluster, vzdump, qm, pct. agent: proxmox-expert --- # Proxmox Skill Proxmox VE virtualization platform reference for VM management, containers, clustering, and homelab infrastructure. ## Quick Reference ```bash # 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](references/vm-lxc.md) | Choosing virtualization type | | Docker Hosting | [docker-hosting.md](references/docker-hosting.md) | Running Docker on Proxmox | | Networking | [networking.md](references/networking.md) | Bridges, VLANs, SDN, firewall | | Storage | [storage.md](references/storage.md) | Storage backends, content types | | Cloud-init | [cloud-init-templates.md](references/cloud-init-templates.md) | VM provisioning with cloud-init | | Clustering | [clustering.md](references/clustering.md) | HA, quorum, fencing | | Backup | [backup.md](references/backup.md) | vzdump modes, restore | | CLI Tools | [cli-tools.md](references/cli-tools.md) | qm, pct, pvecm, pvesh commands | | Troubleshooting | [troubleshooting.md](references/troubleshooting.md) | Common errors, diagnostics | | Automation Tools | [automation-tools.md](references/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 |
© poindexter12 · MIT · poindexter12/waypoint