vm-error-recovery

Diagnose secure workspace startup errors and guide users through recovery steps.

Updated Jun 22, 2026
One-click install
npx skills add https://github.com/sliec/shared-files --skill vm-error-recovery-sliec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vm-error-recovery
Source: https://github.com/sliec/shared-files/tree/main/skills/vm-error-recovery
Command: npx skills add https://github.com/sliec/shared-files --skill vm-error-recovery-sliec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When the QoderWork secure workspace fails to start, users see cryptic errors and don't know how to fix them. This Skill reads the diagnostic state file, identifies the exact error, and walks users through plain-language recovery steps matched to their platform. ## Core Features & Use Cases - Automated Diagnosis: Reads the boot-state.json diagnostic file and maps error keys to specific recovery instructions. - Platform-Aware Guidance: Delivers Windows-specific (Hyper-V, administrator, PowerShell) or macOS-specific (version requirements) instructions based on the detected environment. - Connector Integration: Opens the VM settings page or pre-filled feedback dialog directly through the QoderWork Connector. - Use Case: A user reports "secure workspace won't start." The Skill reads the diagnostic file, finds a download_disk_full error, and guides the user to free up 20 GB of disk space before retrying. ## Quick Start Diagnose why my secure workspace failed to start and walk me through fixing it.

Frequently Asked Questions about vm-error-recovery

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

FAQPage Schema
How do I fix secure workspace startup errors in QoderWork?

Read the boot-state.json diagnostic file in the vm data directory to get the error key, then follow the matching recovery steps. Common fixes include restarting QoderWork, freeing system resources, or cleaning the workspace from Settings.

How to troubleshoot workspace download failures?

Download failures usually stem from network issues, insufficient disk space, or antivirus blocking. Check your internet connection, ensure at least 20 GB of free disk space, and add QoderWork to your security software's allowed list before retrying.

Does the secure workspace work on Windows Home edition?

The secure workspace requires Hyper-V, which Windows Home edition may not support. If Hyper-V is missing from Windows features, the edition is incompatible and the feature cannot be enabled on that machine.

Why does secure workspace startup fail on macOS?

macOS startup failures occur when the system version is older than macOS 14 (Sonoma), resources are insufficient, or workspace files are corrupted. Upgrade macOS via System Settings or clean the workspace to re-download files.

What should I do when the workspace error is not recognized?

For unrecognized errors, restart QoderWork, then clean the workspace from Settings if the problem persists. If it still fails, report the issue through the feedback button with the error key included for technical support.