---
name: screenshot
description: Take a console screenshot of a Proxmox VM and view it
user_invocable: true
arguments:
  - name: vmid
    description: The VM ID to screenshot
    required: true
---

# Screenshot Skill

Take a console screenshot of a Proxmox VM and display it.

## Steps

1. Run the helper script to capture the screenshot:
   ```bash
   /home/maarten/dev/incus-contrib/incusos/helpers/proxmox-screenshot {{vmid}}
   ```
2. Read the output path from stdout
3. Use the Read tool to view the PNG image
4. Describe what the VM console shows (boot stage, errors, prompts, etc.)

## Notes

- The helper handles SSH, PPM capture, and PNG conversion automatically
- Requires `PROXMOX_ROOT_PASSWORD` in env file and `proxmox.yaml` for host
- Only works for VMIDs in allowed ranges (400-499, 800-939)
- Use this PROACTIVELY during deploy scenarios to monitor boot progress
