vm-lab

Execute commands in macOS VMs and verify GUI actions with host-side observations.

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/Khang5687/agent-scripts --skill vm-lab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vm-lab
Source: https://github.com/Khang5687/agent-scripts/tree/main/skills/vm-lab
Command: npx skills add https://github.com/Khang5687/agent-scripts --skill vm-lab

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the testing and validation of GUI automation in macOS VM labs, providing a streamlined approach to ensure GUI tools function correctly under real-world conditions.

Core Features & Use Cases

  • VM Automation: Execute commands within a macOS VM, including GUI automation, TCC prompts, and screenshot capture.
  • Host Verification: Validate VM actions with host-side observations and screenshots.
  • Two-Way Validation: Verify each GUI action through independent signals like tool output and external verifiers.
  • Use Case: When developing a GUI tool that requires testing within a macOS VM, use this Skill to automate the test execution and verification process.

Quick Start

Run the vm-lab skill with the VM name and command to automate a task, e.g., 'vm-lab "macOS Tahoe" "sudo -u steipete -H /bin/zsh -lc '''source ~/.zprofile 2>/dev/null || true; uname -a'''''

Frequently Asked Questions about vm-lab

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate GUI testing in a macOS VM?

macOS VM GUI testing is automated by executing commands within the virtual machine and verifying results through host-side observations and screenshot capture. This approach streamlines validating GUI tools under real-world conditions.

Can I use Parallels to automate macOS VM screenshot capture and validation?

Parallels is required to automate macOS VM screenshot capture and validation. The Skill executes GUI automation commands inside the Parallels VM and verifies actions using independent host-side signals and screenshots.

What's the best way to validate GUI automation actions inside a macOS virtual machine?

Validating GUI automation actions requires a two-way validation approach, verifying each action through independent signals like tool output and external host-side verifiers. This confirms actions execute correctly within the VM.

How do I handle TCC prompts during macOS VM GUI automation?

TCC prompts encountered during macOS VM GUI automation are handled by executing commands that interact with the VM environment. The Skill automates these interactions, capturing screenshots to verify the prompt resolution.

Do I need Parallels to run macOS VM GUI automation testing?

Parallels is required to run macOS VM GUI automation testing. The Skill depends on Parallels to execute commands within the virtual machine and perform host-side verification of GUI actions.

Why verify GUI tool testing with host-side observations instead of VM logs?

Host-side observations provide independent verification of GUI actions, capturing screenshots that confirm tool functionality beyond internal VM logs. This two-way validation ensures GUI tools work correctly under real-world conditions.