windows-macos-input-setup
Configure and verify a Windows 11 PC for macOS-like Logitech keyboard shortcuts, virtual-desktop switching, cross-monitor window movement, and natural scrolling. Use for reproducing or repairing this specific setup without stacking conflicting remappers.
How do I install this agent skill?
npx skills add https://github.com/arthurzakirov/agentdesk --skill windows-macos-input-setupIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill configures Windows 11 to emulate macOS keyboard shortcuts and window management using Microsoft PowerToys. It manages configuration files in the local application data directory, modifies per-user registry settings to prevent shortcut conflicts, and includes PowerShell scripts for system verification. All external references are to official Microsoft documentation and repositories.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Windows macOS Input Setup
Set up a Logitech keyboard in Windows layout so the physical Mac legends behave consistently:
cmd | alt(left of Space) acts as Command for common shortcuts.option | startacts as Option andOption+Tabopens Windows app switching.- Physical Control remains Control.
Control+Tabremains nativeControl+Tabfor switching browser/editor tabs; it must not duplicateOption+Tab.Control+Upopens Windows Task View (Win+Tab) with all windows and virtual desktops, matching macOS Mission Control muscle memory.Control+Left/Rightswitches virtual desktops.Control+Option+Left/Rightmoves the focused window between monitors.- Native
Option+Upmaximizes the focused window because the physical Option key is WindowsLeft Win. Do not useControl+Option+Enter; Windows reserves its physicalWin+Control+Enterchord for Narrator and may consume it despite the Narrator toggle being off. Option+Left/Rightcan be mapped explicitly to WindowsControl+Left/Rightfor word navigation without taking the physicalControl+Left/Rightdesktop shortcuts away.- Windows natural scrolling is enabled when requested.
Read references/setup-and-validation.md before changing the machine. It contains the exact profile, conflict cleanup, current PowerToys caveats, restart procedure, and automatic verification workflow.
Invariants
- Keep only the one-way modifier remap
Left Alt -> Left Ctrl. Never add the reverseLeft Ctrl -> Left Alt: it turns physicalControl+TabintoAlt+Taband duplicatesOption+Tab. Use a small set of explicit, non-overlapping shortcut remaps. PowerToys can keep physicalControl+Left/Rightmapped to desktop switching while separately mapping physicalOption+Left/Rightto text navigation. - Keep
162;38 -> 91;9forControl+UpTask View. Do not remove91;9 -> 164;9; that separate rule preserves physicalOption+Tabas WindowsAlt+Tab. - For virtual-desktop arrows, use physical Left Control as the source but Right
Control in the generated Windows shortcut:
162;37 -> 91;163;37and162;39 -> 91;163;39. Reusing Left Control in the target can fail after the source modifier is suppressed by Keyboard Manager. - Do not run Kinto,
mac-keyboard-behavior-in-windows, or a custom AutoHotkey profile concurrently with this PowerToys profile. - Do not add another remapper to reproduce macOS
Option+Left/Right; use direct PowerToys shortcut rules.Control+Shift+Arrow, then a plain arrow, remains a fallback rather than the preferred configuration. - Back up existing PowerToys configuration before mutation and preserve unrelated settings.
- Restart the full PowerToys runner after profile changes; verify the Keyboard Manager engine is its child process.
- Test observable behavior automatically. Never infer success only from valid JSON or a running process.
- Never configure
Control+Option+Lfor monitor 3 on this layout: it contains protected WindowsWin+Land can lock the PC. Use a safe numeric alternative only when explicitly requested and independently testable. - Never map physical
Control+Option+Enter. Keep Narrator and its keyboard shortcut disabled, and leave nativeOption+Up -> Win+Upunremapped for maximizing. Do not invent a third shortcut scheme.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/arthurzakirov/agentdesk/windows-macos-input-setup">View windows-macos-input-setup on skillZs</a>