incus-contrib/.claude/skills/proxmox-api.md

name	description	user_invocable	arguments
proxmox-api	Make an authenticated Proxmox API call	true	name description required args METHOD PATH [--json] true

Proxmox API Skill

Make an authenticated Proxmox API call with proper token handling.

Steps

1. Run the helper script:

   /home/maarten/dev/incus-contrib/incusos/helpers/proxmox-api {{args}}
   

2. Parse the JSON response
3. Present the results in a readable format

Notes

• The helper handles the ! in automation@pve!deploy safely
• Reads host and token ID from proxmox.yaml, secret from env file
• Add --json for pretty-printed output
• Common paths:
  • /nodes/pve/qemu -- list all VMs
  • /nodes/pve/qemu/{vmid}/status/current -- VM status
  • /nodes/pve/status -- host resources
  • /cluster/resources -- cluster-wide resources
  • /pools/{pool} -- pool members