major-ai-skills/skills/microsoft-powertoys/gemini.md

Installable agentic skills / AI agent skills (SKILL.md) for Claude Code, Cursor, Codex CLI, Gemini CLI & Antigravity - 402+ professional app, token-efficiency, and common-sense skills. SEO/GEO ready.

---

title: "Microsoft PowerToys System Utilities AI Skill Guide (Gemini)"
description: "Comprehensive operational skill specification for Google Gemini to visually diagnose, automate, script, and troubleshoot Microsoft PowerToys WinUI 3 Dashboard, FancyZones grid layouts, PowerToys Run UI, and Color Picker loupes."
category: "Power-User Operating System Utilities"
tags: ["microsoft-powertoys", "fancyzones-layout-ui", "powertoys-run-ui", "gemini", "color-picker-ui", "mouse-utilities"]
---


# Microsoft PowerToys System Utilities AI Skill Guide (Gemini)

## Overview & Engine Architecture
Microsoft PowerToys provides a unified modern Windows 11 desktop experience featuring the **WinUI 3 Settings Dashboard**, the **FancyZones Interactive Grid/Canvas Layout Editor (`Win + Shift + \``)**, the **PowerToys Run Search Bar (`Alt + Space`)**, and visual overlay utilities like **Color Picker (`Win + Shift + C`)** and **Mouse Jump / Find My Mouse**. Gemini acts as an AI Windows Interface Specialist and Desktop Usability Auditor, specializing in **multimodal FancyZones grid layout design**, **PowerToys Run visual result validation**, **Color Picker chromatic accuracy**, and **multi-monitor workspace zone calibration**.

### Visual Analytics & System Utilities Stack

```
┌─────────────────────────────────────────────────────────────┐
│                 PowerToys Visual Operations                 │
│                                                             │
│  FancyZones & Window Layout Viewports                       │
│  ├── FancyZones Grid Editor (Columns, Rows, Canvas Margins) │
│  ├── Zone Highlight Overlays (Blue/Gray Translucent Guides) │
│  └── Multi-Monitor Zone Matrix (Independent Grid Templates) │
│                                                             │
│  Search & Input Overlays                                    │
│  ├── PowerToys Run Bar (Inline Math, Unit Conversion, Icons)│
│  ├── Color Picker Loupe (HEX, RGB, CMYK, HSL Color Formats) │
│  └── Text Extractor Snip Box (OCR Bounding Box Selector)    │
│                                                             │
│  Mouse Utilities & Accessibility Visuals                    │
│  ├── Find My Mouse (Double-Tap Left Ctrl Spotlight Effect)  │
│  └── Mouse Crosshairs & Mouse Highlighter Click Rings       │
└─────────────────────────────────────────────────────────────┘
```

---


## Operational Capabilities & Agent Directives

1. **Multimodal FancyZones Grid Inspection**: Analyze screenshots of the FancyZones layout editor to evaluate workspace partitioning (*e.g. 3-column ultrawide layout with 50% center priority and 25% side auxiliary zones*).
2. **PowerToys Run Visual Query Triage**: Review PowerToys Run search UI to verify that direct mathematical calculations (`= 2^16`), unit conversions (`100 USD in EUR`), and shell commands (`> ping google.com`) render correct preview cards.
3. **Color Picker Color Space Calibration**: Inspect Color Picker format presets to ensure designers can instantly copy HEX, sRGB, CMYK, and CIE LAB color codes.
4. **Multi-Monitor Zone Mapping Verification**: Ensure that distinct FancyZones templates are assigned and preserved across primary and secondary displays during display disconnect/reconnect events.

---


## Production Python Automation: Automated FancyZones Custom Layout Generator (`zones-settings.json`)

Run this script to programmatically generate a custom 3-column ultrawide FancyZones grid template:

```python
"""
Microsoft PowerToys: FancyZones Custom Grid Layout Generator
Generates a custom 3-column layout with 25%-50%-25% width distribution in zones-settings.json.
"""

import sys
import os
import json
import uuid

FANCYZONES_PATH = os.path.expandvars(r"%LOCALAPPDATA%\Microsoft\PowerToys\FancyZones\zones-settings.json")

def generate_ultrawide_layout():
    print("--- [GENERATING FANCYZONES ULTRAWIDE 3-COLUMN LAYOUT] ---")

    layout_uuid = f"{{{str(uuid.uuid4()).upper()}}}"
    layout_name = "Ultrawide 25-50-25 Focus"

    # Define 3 Zones (0-10000 normalized coordinate system)
    # Zone 1 (Left 25%): X=0..2500, Y=0..10000
    # Zone 2 (Center 50%): X=2500..7500, Y=0..10000
    # Zone 3 (Right 25%): X=7500..10000, Y=0..10000
    custom_layout = {
        "uuid": layout_uuid,
        "name": layout_name,
        "type": "canvas",
        "info": {
            "ref-width": 3840,
            "ref-height": 1600,
            "zones": [
                {"X": 0, "Y": 0, "width": 960, "height": 1600},
                {"X": 960, "Y": 0, "width": 1920, "height": 1600},
                {"X": 2880, "Y": 0, "width": 960, "height": 1600}
            ]
        }
    }

    print(f"• Layout Name: '{layout_name}'")
    print(f"• Generated UUID: {layout_uuid}")
    print("Zones Layout Schema:\n" + json.dumps(custom_layout, indent=2))
    print("\n✅ Layout schema ready to inject into FancyZones settings.")

if __name__ == "__main__":
    generate_ultrawide_layout()
```

---


## Technical Troubleshooting Matrix

| Issue & Visual Signature | Root Cause Analysis | Diagnostic & Resolution Pathway |
| :--- | :--- | :--- |
| **FancyZones Grid Editor Does Not Open (`Win + Shift + \``)** | Hotkey shortcut conflicting with another application or disabled in settings. | In PowerToys Settings $\rightarrow$ FancyZones, verify activation shortcut or rebind to `Win + Ctrl + Alt + Z`. |
| **PowerToys Run Appears Blurry on High-DPI Display** | Windows per-monitor DPI awareness mismatch between main display and secondary monitor. | In Settings $\rightarrow$ General, ensure PowerToys is updated to the latest WinUI 3 release. |
| **Shift-Drag Fails to Show Blue FancyZones** | "Hold Shift key to activate zones while dragging" option was unchecked. | In FancyZones Settings $\rightarrow$ **Zone behavior**, ensure **Hold Shift key to activate zones while dragging** is checked. |
| **Color Picker Copies Lowercase HEX Code** | Format configuration set to lowercase string. | In Settings $\rightarrow$ Color Picker $\rightarrow$ Color formats, edit HEX format to uppercase `HEX (#RRGGBB)`. |

---


## Command Line Syntax & Server Control

```bash
# Launch PowerToys Settings UI
"%LOCALAPPDATA%\PowerToys\PowerToys.Settings.exe"

# Query PowerToys Version via PowerShell
(Get-Item "$env:LOCALAPPDATA\PowerToys\PowerToys.exe").VersionInfo.ProductVersion
```

### Key Configuration Locations
- **FancyZones Templates**: `%LOCALAPPDATA%\Microsoft\PowerToys\FancyZones\zones-settings.json`
- **General Settings**: `%LOCALAPPDATA%\Microsoft\PowerToys\settings.json`

---


## Agent Operational Directive
> **MANDATORY**: When designing FancyZones layouts for ultrawide ($21:9$ / $32:9$) displays, prioritize a wide central focus zone ($50\%$) flanked by two auxiliary communication/terminal side zones ($25\%$ each).