A Claude Code skill for administering Proxmox VE (PVE) hosts and clusters: VMs, LXC containers, storage, Ceph, networking, firewall, backups, clustering, HA, users, and the REST API — plus guest performance tuning. It operates hybrid: it advises with exact commands and config by default, and executes against a live node when one is reachable — always with safety guardrails for destructive operations.
skill-proxmox/
├── .claude-plugin/
│ ├── plugin.json # plugin manifest (proxmox)
│ └── marketplace.json # marketplace manifest (3shn-proxmox)
└── skills/proxmox/
├── SKILL.md # execute/advise model · safety guardrails · /etc/pve model · routing
├── references/ # 13 command-level guides (one per domain)
│ ├── vms.md containers.md storage.md ceph.md backup.md
│ ├── cluster.md ha-replication.md network.md firewall.md
│ └── users.md api.md performance.md troubleshooting.md
└── scripts/
└── pve-preflight.sh # safe, read-only host orientation snapshot
- VMs (
qm) — create/clone/config, disks, snapshots, migration, templates, cloud-init. - Containers (
pct) — create/config, templates, bind mounts, snapshots, privileged vs unprivileged. - Storage (
pvesm) — ZFS, LVM-thin, dir, NFS/CIFS, content types, disk ops, thin provisioning/TRIM. - Ceph (
pveceph) — hyper-converged RBD/CephFS, OSDs, pools, health. - Backup (
vzdump/PBS) — modes, scheduled jobs, retention/pruning, restore to a new VMID. - Cluster (
pvecm) — create/join, quorum, corosync, pmxcfs, recovery. - HA + replication (
ha-manager,pvesr) — resources, groups, fencing, ZFS replication. - Networking — bridges, VLANs (VLAN-aware), bonds, separate cluster/storage networks, SDN basics.
- Firewall — datacenter/host/guest levels, security groups, enabling without locking yourself out.
- Users (
pveum) — realms, roles, ACLs, resource pools, API tokens (privsep), 2FA. - API (
pvesh) — local CLI over the REST API, tokens, async tasks, remotecurl. - Performance — virtio-scsi + iothread, cache/discard, ballooning, NUMA, ZFS ARC, and more.
- Troubleshooting — logs, quorum/pmxcfs recovery, stuck locks, storage/network issues, passthrough.
Many PVE operations are irreversible. The skill confirms before destructive actions
(qm/pct destroy, pvesm remove, disk wipes, pvecm delnode), backs up before risky changes,
never shrinks disks in place, and respects cluster quorum. Run the bundled preflight first:
bash skills/proxmox/scripts/pve-preflight.sh # read-only: version, quorum, storages, guests, next VMIDAdd the marketplace and enable the plugin:
/plugin marketplace add 3shn/skill-proxmox
/plugin install proxmox@3shn-proxmox
Or, for a single repo, drop skills/proxmox/ into that project's .claude/skills/. Either way,
restart the session so the skill is discovered.
MIT © 2026 Yu Shen