Tooluck logoTooluck
SKILL.md

skillshare-windows-utm

Agent skill fromrunkids/skillshare

Verify skillshare on a real Windows guest running in local UTM: build a pinned commit in the devcontainer, push it into the VM, and either run the Windows E2E runbook with full and basic-user tokens or hand the maintainer a one-line hands-on setup. Use this whenever a change touches Windows links, junctions, file symlinks, Developer Mode, copy fallback, Windows paths, or the dashboard on Windows, or when the user asks to test or accept something on Windows / UTM.

How to install skillshare-windows-utm

install skillshare-windows-utm
# install the skillshare pack with the skills CLI
npx skills add runkids/skillshare

# or add only this skill to Claude Code: copy the folder

.skillshare/skills/skillshare-windows-utm/

# into

~/.claude/skills/skillshare-windows-utm/ (all projects)

.claude/skills/skillshare-windows-utm/ (one project)

.skillshare/skills/skillshare-windows-utm/SKILL.md

MITFull file
1Linux tests cannot show Windows link behavior. This skill drives the local UTM guest with
2`scripts/windows/utm.sh`. Before acting, run `python3 scripts/ai-context.py testing` and follow its
3"Windows Verification" section; it is the source of truth for the rules below.
4
5## Rules
6
7- Build in the devcontainer from a **pinned commit** (`utm.sh build <ref>`), never from the working
8 tree: other work may be editing it. Report the commit hash with every result.
9- The host only drives the VM (`utmctl`). Never run `ss`, `go` or `pnpm` on the host.
10- `utmctl exec` runs as SYSTEM, which can always create symlinks. Product behavior must run as the
11 desktop user through `utm.sh task` (Interactive scheduled task). Use `--basic` for the basic-user
12 token (`runas /trustlevel:0x20000`), which has no symlink right. Never switch to S4U: its token
13 differs from a real user's.
14- Isolate automated runs under `C:\Users\Public\sstest\`. Clean up with `utm.sh clean`, which uses
15 `rmdir` (it does not follow junctions).
16- Report which token (full or basic) and architecture each result came from.
17
18## 1. Preflight
19
20```sh
21scripts/windows/utm.sh probe
22```
23
24| Output | Meaning and action |
25|---|---|
26| `stopped` | `utmctl start Windows`, then probe again after boot. |
27| `OSStatus -1712` | macOS Automation permission for the terminal app is missing; ask the user to allow it. |
28| `OSStatus -2700` / guest agent error | Guest still booting or agent not up. Wait, then retry. |
29…

Excerpt shown under the repository's MIT license.

More skills in skillshare

Keep exploring

Similar skill repositories

thedotmack /

claude-mem
116k

Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More

CCCXGHGM+135 skills

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates