Agent skill
screenshot
Find and display recent screenshots. Triggers: screenshot, check screenshot, show screenshot, recent screenshot, last screenshot.
Install this agent skill to your Project
npx add-skill https://github.com/0xDarkMatter/claude-mods/tree/main/skills/screenshot
SKILL.md
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
- Windows:
-
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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
log-ops
Log analysis and JSONL processing - structured extraction, cross-log correlation, timeline reconstruction, pattern search
data-processing
Process JSON with jq and YAML/TOML with yq. Filter, transform, query structured data efficiently. Triggers on: parse JSON, extract from YAML, query config, Docker Compose, K8s manifests, GitHub Actions workflows, package.json, filter data.
testgen
Generate tests with expert routing, framework detection, and auto-TaskCreate. Triggers on: generate tests, write tests, testgen, create test file, add test coverage.
vue-ops
Vue 3 development patterns, Composition API, Pinia state management, Vue Router, and Nuxt 3. Use for: vue, vuejs, composition api, pinia, vue router, nuxt, nuxt3, script setup, composable, reactive, defineProps, defineEmits, defineModel, v-model, provide inject, vue3.
python-cli-ops
CLI application patterns for Python. Triggers on: cli, command line, typer, click, argparse, terminal, rich, console, terminal ui.
claude-code-debug
Troubleshoot Claude Code extensions and behavior. Triggers on: debug, troubleshoot, not working, skill not loading, hook not running, agent not found.
Didn't find tool you were looking for?