Screenshot Viewer Skill

Screenshot Viewer

Quickly find and display recent screenshots from common screenshot directories.

Usage

/screenshot          # Show last 5 screenshots (default)
/screenshot 1        # Show only the most recent
/screenshot 10       # Show last 10 screenshots

How It Works

Auto-detect screenshot locations - Checks common directories in this order:
- Windows: Pictures\Screenshots, ShareX, Greenshot, OneDrive\Screenshots
- macOS: ~/Desktop, ~/Screenshots
- Linux: ~/Pictures, ~/Desktop
Find recent screenshots - Uses Glob to find image files (png, jpg, jpeg, gif, webp) sorted by modification time
Display visually - Uses Read tool to show screenshots so you can analyze and discuss them

Implementation

Step 1: Detect Screenshot Directory

Check common locations and use the first one that exists:

Windows:

# Priority order
1. %USERPROFILE%\Pictures\Screenshots           # Windows 11 native
2. %USERPROFILE%\Documents\ShareX\Screenshots   # ShareX
3. %USERPROFILE%\Pictures\Greenshot             # Greenshot
4. %USERPROFILE%\OneDrive\Pictures\Screenshots  # OneDrive sync
5. %USERPROFILE%\Pictures                       # Fallback

macOS:

1. ~/Desktop              # Default macOS location
2. ~/Screenshots          # Custom folder
3. ~/Pictures             # Fallback

Linux:

1. ~/Pictures/Screenshots # GNOME/KDE
2. ~/Pictures             # Fallback
3. ~/Desktop              # Alternative

Step 2: Find Recent Screenshots

Use Glob to find image files, sorted by modification time:

# Find all image files in screenshot directory
fd -e png -e jpg -e jpeg -e gif -e webp . "$SCREENSHOT_DIR" --max-depth 1 -t f --exec stat --format="%Y %n" {} \; | sort -rn | head -n $COUNT

Or using native tools:

Windows (PowerShell):

Get-ChildItem "$env:USERPROFILE\Pictures\Screenshots" -File |
  Where-Object {$_.Extension -match '\.(png|jpg|jpeg|gif|webp)$'} |
  Sort-Object LastWriteTime -Descending |
  Select-Object -First $COUNT

Unix (Bash):

find "$SCREENSHOT_DIR" -maxdepth 1 -type f \( -iname "*.png" -o -iname "*.jpg" -o -iname "*.jpeg" -o -iname "*.gif" -o -iname "*.webp" \) -printf '%T@ %p\n' | sort -rn | head -n $COUNT | cut -d' ' -f2-

Step 3: Display Screenshots

For each screenshot found, use Read tool to display it visually:

Found 3 screenshots in C:\Users\...\Pictures\Screenshots

1. Screenshot_2026-01-28_14-32-10.png (45 KB, 2 minutes ago)
[Read tool displays image visually]

2. Screenshot_2026-01-28_14-15-03.png (128 KB, 19 minutes ago)
[Read tool displays image visually]

3. Screenshot_2026-01-28_13-58-22.png (67 KB, 36 minutes ago)
[Read tool displays image visually]

Arguments

| Argument | Default | Description | |----------|---------|-------------| | count | 5 | Number of screenshots to show |

Examples:

/screenshot - Show last 5
/screenshot 1 - Show only most recent
/screenshot 10 - Show last 10

Output Format

Screenshots from [directory]

## Screenshot 1 of N
**File**: [filename]
**Size**: [size] KB
**Modified**: [time ago]

[Visual display of screenshot via Read tool]

## Screenshot 2 of N
...

Edge Cases

No Screenshot Directory Found

No screenshot directory found.

Checked locations:
  - C:\Users\...\Pictures\Screenshots (not found)
  - C:\Users\...\Documents\ShareX\Screenshots (not found)
  - C:\Users\...\Pictures\Greenshot (not found)

To use this skill, either:
  1. Take a screenshot (Win+Shift+S on Windows)
  2. Specify a custom directory: /screenshot --dir="C:\path\to\screenshots"

No Screenshots Found

No screenshots found in C:\Users\...\Pictures\Screenshots

Directory exists but contains no image files (.png, .jpg, .jpeg, .gif, .webp)

Count Exceeds Available

Found 3 screenshots (requested 10)

Showing all 3:
[displays all available screenshots]

Performance

Fast - Uses filesystem tools (fd or native) instead of reading all files
Efficient - Only reads the exact number requested
Token-conscious - Large screenshots are automatically resized by Read tool

Custom Directory (Optional)

To use a non-standard directory:

/screenshot 5 --dir="C:\Custom\Path"

Or create a project-specific config in .claude/screenshot.json:

{
  "directory": "C:\\Custom\\Screenshots",
  "default_count": 3,
  "file_extensions": ["png", "jpg", "webp"]
}

Integration

Works well with:

/explain - Explain what's in the screenshot
/review - Review UI/code in screenshot
Browser automation tools - Verify screenshot matches expected state

Notes

Respects modification time (newest first)
Ignores subdirectories (only top-level)
Supports common image formats (png, jpg, jpeg, gif, webp)
Works across Windows, macOS, Linux with platform-specific paths

Agent Skills: Screenshot Viewer

Install this agent skill to your local

Skill Files