Skip to content

About

Proxmox VE administration skill for Claude Code (qm/pct/pvesm/Ceph/vzdump/pvecm/ha-manager/pveum/pvesh + perf tuning).

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

proxmox — Proxmox VE Administration (Claude Code skill / plugin)

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.

What's inside

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

What it does

  • 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, remote curl.
  • Performance — virtio-scsi + iothread, cache/discard, ballooning, NUMA, ZFS ARC, and more.
  • Troubleshooting — logs, quorum/pmxcfs recovery, stuck locks, storage/network issues, passthrough.

Safety

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 VMID

Install

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

License

MIT © 2026 Yu Shen

About

Proxmox VE administration skill for Claude Code (qm/pct/pvesm/Ceph/vzdump/pvecm/ha-manager/pveum/pvesh + perf tuning).

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages