AgentSkillsCN

create-vm

在已配置的后端（libvirt或proxmox）上创建一个新的NixOS虚拟机。当用户想要创建新的虚拟机时使用。

SKILL.md
--- frontmatter
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 VM Skill

Create a new NixOS VM on the configured backend.

Instructions

Step 1: Determine Backend

Read the .env file to determine which backend is configured (libvirt or proxmox).

Step 2: Get Available Profiles

Run just list-profiles to get the list of available profiles. Use this to populate the profile selection.

Step 3: Gather VM Settings

Ask the user for the following settings:

  1. •

    Name (required) - Free text input, single word VM name. Do not offer multiple choice, let them type it.

  2. •

    VMID (Proxmox only) - If the backend is proxmox, ask whether to use automatic or manual VMID:

    • •Automatic (recommended) - Let Proxmox allocate the next available VMID
    • •Manual - Type a specific VMID (integer, typically 100-999999)

    Skip this question entirely for libvirt backend.

  3. •

    Profile - Multiple choice from the output of just list-profiles. Common profiles:

    • •core - Base system with SSH (recommended for most uses)
    • •docker - Core + Docker
    • •dev - Development environment with Docker and Podman
  4. •

    Memory - RAM in MB. Offer choices:

    • •1024 (1 GB)
    • •4096 (4 GB)
    • •8192 (8 GB)
    • •Or type a custom value
  5. •

    vCPUs - Number of virtual CPU cores. Offer choices:

    • •1
    • •2
    • •4
    • •Or type a custom value (any integer >= 1)
  6. •

    Var Size - Size of /var partition in gigabytes. Offer choices:

    • •20
    • •50
    • •100
    • •Or type a custom value (any integer >= 1)
  7. •

    Network - Depends on the backend:

    • •libvirt: Offer nat or bridge
    • •proxmox: Offer bridge:vmbr0, bridge:vmbr1, or type custom

Step 4: Create the VM

Run the create command:

bash
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:

bash
PVE_VMID={VMID} just create {NAME} {PROFILE} {MEMORY} {VCPUS} {VAR_SIZE} {NETWORK}

Step 5: Report Results

Tell the user the VM has been created and provide:

  • •The VM name
  • •How to start it: just start {NAME}
  • •How to check status: just status {NAME}
  • •How to SSH into it: just ssh {NAME} or just ssh admin@{NAME}