Skip to main content
hc
Submit
skillsFirst-partyReview first Safety · Privacy ·

Proxmox VE API Orchestrator Skill

Orchestrate Proxmox VM and LXC lifecycle operations via API with safe sequencing, capacity checks, and rollback-aware automation.

by JSONbored·added 2026-04-10·
Claude CodeCodexWindsurfGeminiCursorCLI
HarnessClaude CodeCodexWindsurfGeminiCursorCLI
Level:advancedType:generalVerified:draft
Review first — review before installing

Open the source and read safety notes before installing.

Prerequisites

  • Proxmox VE cluster or node API access
  • Token-based auth with scoped permissions
  • Defined operational policy for infra changes

Schema details

Install type
package
Reading time
7 min
Difficulty score
79
Troubleshooting
Yes
Breaking changes
No
Package metadata
Package verified
Yes
SHA-256
8c49dff8580bad344aeda18707159b9ad25bc7eef25946d6c429ac65cb7565b0
Skill and platform metadata
Skill type
general
Skill level
advanced
Verification
draft
Verified at
2026-04-10
Retrieval sources
https://pve.proxmox.com/mediawiki/index.php?title=Proxmox_VE_API
Tested platforms
ClaudeCodexOpenClawCursorWindsurfGemini
PlatformSupportInstall path
claude-codeNative.claude/skills/<skill-name>/SKILL.md
codexNative.agents/skills/<skill-name>/SKILL.md
windsurfNative.windsurf/skills/<skill-name>/SKILL.md
geminiNative.gemini/skills/<skill-name>/SKILL.md or .agents/skills/<skill-name>/SKILL.md
cursorAdapter.cursor/rules/<skill-name>.mdc
cliManualAGENTS.md or tool-specific context file
Full copyable content
# Trigger
"Run the Proxmox VE API orchestrator skill for this infrastructure request."

# Required output
1) Pre-flight checks (capacity, node health, locks)
2) Operation sequence with dependencies
3) Failure and rollback handling
4) Post-operation verification report

About this resource

Overview

This skill helps AI agents orchestrate Proxmox operations in a way that is safe for real infrastructure. It emphasizes pre-flight validation, explicit sequencing, and validation after each change.

Compatibility

Native

  • Claude Code / Claude: native skill usage via SKILL.md.
  • Codex/OpenAI workflows: compatible with Agent Skills-style SKILL.md content as reusable workflow instructions.

Manual Adaptation

  • Gemini CLI: native skill usage via .gemini/skills/<skill-name>/SKILL.md or .agents/skills/<skill-name>/SKILL.md where supported.
  • Cursor: use the generated .cursor/rules/*.mdc adapter for project rules.
  • OpenClaw and similar agents: use the same skill content as a reusable prompt/workflow file when native skill import is unavailable.

Prerequisites

  • Inventory of target nodes, VMs, and LXCs
  • Maintenance window and rollback criteria
  • Backup/snapshot policy for stateful workloads

What This Skill Delivers

  • Operation plans for create/update/migrate/backup/restore
  • Cluster-safe sequencing and lock awareness
  • Capacity and health validation checks
  • Change reporting with verification evidence

How to Use This Skill

  1. Gather current cluster state and constraints.
  2. Build deterministic operation graph.
  3. Gate risky operations behind approvals.
  4. Execute with bounded retries and timeout limits.
  5. Validate final state and produce run report.

Troubleshooting

Issue: Migration operations fail mid-flight
Fix: Add pre-flight checks for storage/network/node health and fallback target node.

Issue: API token works but operation is denied
Fix: Review token role scopes and map required privileges per endpoint.

Issue: Post-change drift appears hours later
Fix: Add delayed verification checks for resource pressure and service health.

Knowledge Freshness

Treat tooling details as time-sensitive. Re-validate APIs, limits, pricing, auth models, and deployment flags immediately before implementation. If docs conflict with prior memory, follow current official docs and release notes.

Retrieval Sources

Output Contract

  1. Return a concrete plan with implementation order.
  2. Provide production-ready commands/config/code snippets (not placeholders).
  3. Include explicit assumptions and unresolved risks.
  4. Include a verification checklist with pass/fail criteria.

Quality Gates

  • All commands are copy/paste ready.
  • Security-sensitive steps call out secret handling and least privilege.
  • Version-sensitive guidance cites current docs used.
  • Rollback path is included for risky changes.
  • Final output includes quick validation commands/tests.
Content outline
#proxmox#virtualization#infrastructure#api#homelab

Source citations

Signals

Loading live community signals…

More like this, weekly

A short, calm digest of reviewed Claude resources. Unsubscribe any time.