screenshot-capture

Capture screenshots of windows or monitors. Use this skill when you need to take a screenshot for testing, debugging, or documentation purposes. Supports cross-virtual-desktop capture and annotation.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️2downloads

When & Why to Use This Skill

This Claude skill provides a robust solution for capturing and annotating screenshots across windows and monitors, specifically optimized for developer and QA workflows. It features unique cross-virtual-desktop capture capabilities, automatic image resizing for efficient AI processing, and precise annotation tools like grids and rectangles to enhance debugging, testing, and technical documentation.

Use Cases

  • Software Testing & QA: Automatically capture specific application windows to document UI bugs or verify visual consistency during quality assurance cycles.
  • Multi-Desktop Debugging: Capture content from windows residing on different virtual desktops using the PrintWindow API without the need to manually switch workspaces.
  • Technical Documentation: Create professional-grade guides by adding coordinate-based grids and highlighted rectangles to screenshots for clear visual instructions.
  • AI Visual Analysis: Scale down high-resolution captures (e.g., 4K) to manageable sizes (1920px width) for efficient processing and analysis by vision-capable AI models.
namescreenshot-capture
descriptionCapture screenshots of windows or monitors. Use this skill when you need to take a screenshot for testing, debugging, or documentation purposes. Supports cross-virtual-desktop capture and annotation.

Screenshot Capture

Capture screenshots using PowerShell with support for cross-virtual-desktop window capture.

Output Location

Screenshots saved to .screenshots/ at repo root (in .gitignore).

Important: Resize Large Captures

When capturing screenshots to read/analyze, always use -MaxWidth 1920 or smaller to keep file size manageable. Large screenshots (e.g., 3440x1440) should be scaled down for efficient processing.

Quick Reference

User Says Command What Happens
"POE2 window" -WindowTitle "Path of Exile" Captures window content directly via PrintWindow (works across VD)
"POE2 monitor" -WindowTitle "Path of Exile" -CaptureMonitor Switches to POE2's VD, captures full monitor, switches back
"monitor 0" -Monitor 0 Captures primary monitor (current desktop)

Three Use Cases

1. Capture Monitor

.\.claude\skills\screenshot-capture\scripts\capture_screenshot.ps1 -Monitor 0

2. "POE2 window" - Capture Window Content

Captures window content directly using PrintWindow API. Works across virtual desktops without switching.

.\.claude\skills\screenshot-capture\scripts\capture_screenshot.ps1 -WindowTitle "Path of Exile" -OutputName "poe2_window" -MaxWidth 1920

3. "POE2 monitor" - Capture Window's Monitor

Switches to window's virtual desktop, captures the full monitor, switches back.

.\.claude\skills\screenshot-capture\scripts\capture_screenshot.ps1 -WindowTitle "Path of Exile" -CaptureMonitor -OutputName "poe2_monitor" -MaxWidth 1920

Capture Parameters

Parameter Description
-WindowTitle Partial window title to match
-Monitor Monitor index (0 = primary)
-CaptureMonitor Capture full monitor of window (with VD switching)
-OutputName Custom filename (without extension)
-MaxWidth Scale down if wider
-MaxHeight Scale down if taller
-NoSwitchBack Stay on target VD after capture

Annotation Features

Add Grid with Percentage Markers

# "add grid to poe2_window.png"
.\.claude\skills\screenshot-capture\scripts\annotate_screenshot.ps1 -InputPath "poe2_window.png" -AddGrid

Draw Rectangle at Percentage Coordinates

# "draw rectangle from 45,35 to 75,65 on poe2.png"
.\.claude\skills\screenshot-capture\scripts\annotate_screenshot.ps1 -InputPath "poe2.png" -DrawRect "45,35,75,65"

Combined Grid + Rectangle

.\.claude\skills\screenshot-capture\scripts\annotate_screenshot.ps1 -InputPath "poe2.png" -AddGrid -DrawRect "45,35,75,65"

Annotation Parameters

Parameter Description
-InputPath Input image (filename if in .screenshots/)
-OutputPath Output path (default: adds _annotated suffix)
-AddGrid Add 10% gridlines with markers
-DrawRect Rectangle(s) as "X1,Y1,X2,Y2" percentages
-GridColor Grid color (default: Yellow)
-RectColor Rectangle color (default: Red)

List Windows

.\.claude\skills\screenshot-capture\scripts\list_windows.ps1

Shows all windows with virtual desktop status (Current/Other).