Menu
Create a new NixOS VM on the configured backend (libvirt or proxmox). Use this when the user wants to create a new virtual machine.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Set up a new nixos-vm-template context for managing VMs on a hypervisor (libvirt, proxmox KVM, or proxmox-lxc containers). Use this when the user wants to configure a new VM management context, create an alias, or set up environment variables for a backend.
Completely remove a VM including its machine config. Use when user wants to permanently delete everything about a VM.
Recreate a VM from its existing machine config. Use when user wants to rebuild a destroyed VM or reset a VM to fresh state.
Create or restore VM backups. Use for full VM backups that can survive VM destruction.
Clone an existing VM to create a new VM with copied /var data but fresh identity.
Destroy a VM and its disks. Use when user wants to remove a VM but keep its machine config for later recreation.
| name | create-vm |
| description | Create a new NixOS VM on the configured backend (libvirt or proxmox). Use this when the user wants to create a new virtual machine. |
| allowed-tools | Read, Bash, AskUserQuestion |
Create a new NixOS VM on the configured backend.
Read the .env file to determine which backend is configured (libvirt or proxmox).
Run just list-profiles to get the list of available profiles. Use this to populate the profile selection.
Ask the user for the following settings:
Name (required) - Free text input, single word VM name. Do not offer multiple choice, let them type it.
VMID (Proxmox only) - If the backend is proxmox, ask whether to use automatic or manual VMID:
Skip this question entirely for libvirt backend.
Profile - Multiple choice from the output of just list-profiles. Common profiles:
core - Base system with SSH (recommended for most uses)docker - Core + Dockerdev - Development environment with Docker and PodmanMemory - RAM in MB. Offer choices:
vCPUs - Number of virtual CPU cores. Offer choices:
Var Size - Size of /var partition in gigabytes. Offer choices:
Network - Depends on the backend:
nat or bridgebridge:vmbr0, bridge:vmbr1, or type customRun the create command:
just create {NAME} {PROFILE} {MEMORY} {VCPUS} {VAR_SIZE} {NETWORK}
For var_size, append G to the number (e.g., 20G, 50G).
Proxmox with manual VMID: If the user specified a manual VMID, prefix the command with the PVE_VMID environment variable:
PVE_VMID={VMID} just create {NAME} {PROFILE} {MEMORY} {VCPUS} {VAR_SIZE} {NETWORK}
Tell the user the VM has been created and provide:
just start {NAME}just status {NAME}just ssh {NAME} or just ssh admin@{NAME}