Skreenshot

Organize, tag, search, and manage macOS screenshots with OCR, bulk renaming, folder categorization, cleanup, and CleanShot X integration.

macOS accumulates screenshots rapidly—on the Desktop by default, often forgotten and unorganized. This skill provides workflows to tame the chaos.

Quick Start

Find screenshots:

bash

# List recent screenshots (last 7 days)
find ~/Desktop -name "Screenshot*.png" -mtime -7 | head -20

# Search by content (OCR)
textsnip -i ~/Desktop/Screenshot*.png | grep -i "receipt"

Organize:

bash

# Move to categorized folders
mkdir -p ~/Pictures/Screenshots/{work,personal,receipts,memes}
mv ~/Desktop/Screenshot*.png ~/Pictures/Screenshots/personal/

Default Screenshot Location

macOS saves to ~/Desktop by default. Change it:

bash

# Set custom location
defaults write com.apple.screencapture location ~/Pictures/Screenshots
killall SystemUIServer

Screenshot Naming Patterns

Default: Screenshot YYYY-MM-DD at HH.MM.SS.png

Smart rename with context:

bash

# Use script for batch rename with date + optional tags
python scripts/rename_screenshots.py --add-tags work,receipt

OCR Search

Search screenshot content with OCR tools:

• textsnip (CLI): textsnip -i *.png | grep "search term"
• EasyOCR (Python): See references/ocr-setup.md
• macOS built-in: Live Selection (Cmd+Shift+4 then drag)

Organization Strategies

By Project/Client

text

Pictures/Screenshots/
├── client-acme/
├── client-globex/
└── personal/

By Category

text

Pictures/Screenshots/
├── receipts/
├── bugs/
├── inspiration/
├── memes/
└── reference/

By Date (auto-archive)

text

Pictures/Screenshots/
├── 2026/
│   ├── 01-january/
│   ├── 02-february/
│   └── ...

CleanShot X Integration

If using CleanShot X:

• Screenshots save to custom folder (configurable)
• OCR built-in (Cmd+Shift+O)
• Auto-upload to cloud (optional)

See references/cleancast-x.md for workflow details.

Automation Scripts

scripts/rename_screenshots.py

Batch rename with smart patterns (date, app name, tags).

scripts/archive_old_screenshots.py

Move screenshots older than N days to archive folder.

scripts/ocr_search.py

Search all screenshots by text content.

Workflow Examples

"Find that screenshot of the error message"

1. Search by date range (when did you see the error?)
2. OCR search for error text
3. Open matching results

"Organize my Desktop screenshots"

1. Run archive script for old screenshots
2. Move recent ones to categorized folders
3. Update links if needed (wikilinks, docs)

"Search all screenshots for 'invoice'"

1. Run OCR search script
2. Filter results by date/category
3. Return matches with preview

---

References:

• references/ocr-setup.md - OCR tool setup and usage
• references/cleancast-x.md - CleanShot X workflows
• references/automation-patterns.md - Advanced automation scripts