CtrlK
BlogDocsLog inGet started
Tessl Logo

screenshot

Find and display recent screenshots. Triggers: screenshot, check screenshot, show screenshot, recent screenshot, last screenshot.

Install with Tessl CLI

npx tessl i github:NeverSight/skills_feed --skill screenshot
What are skills?

85

Review — 83%

Does it follow best practices?

Validation — 9 / 11 Passed

Validation for skill structure

SKILL.md
Review
Evals

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

  1. Auto-detect screenshot locations - Checks common directories in this order:

    • Windows: Pictures\Screenshots, ShareX, Greenshot, OneDrive\Screenshots
    • macOS: ~/Desktop, ~/Screenshots
    • Linux: ~/Pictures, ~/Desktop

  2. Find recent screenshots - Uses Glob to find image files (png, jpg, jpeg, gif, webp) sorted by modification time

  3. 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

ArgumentDefaultDescription
count5Number 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
Repository
NeverSight/skills_feed
Commit

5c15b3d

Last updated
Created

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.

Claim skill