Skreenshot
Organize, tag, search, and manage screenshots on macOS. Use when users need to: (1) find specific screenshots, (2) organize screenshots into folders by category/project, (3) search screenshot content via OCR, (4) bulk rename or move screenshots, (5) clean up old screenshots, or (6) integrate with CleanShot X or macOS screenshot tool.
About this skill
Skreenshot is an AI agent skill designed to bring order to the often chaotic collection of screenshots on macOS desktops. By default, macOS scatters screenshots across the desktop, quickly leading to clutter and making specific images hard to find. This skill offers a suite of commands and strategies to automate the process of organizing, categorizing, and searching through these visual assets, transforming a messy desktop into an organized archive. The skill provides practical workflows for various screenshot management tasks. Users can quickly find recent screenshots, search image content using OCR tools like `textsnip` for specific text (e.g., receipts), and bulk rename files with custom tags or date information. It facilitates moving screenshots into structured folder systems, whether by project, client, category (e.g., receipts, bugs), or date for long-term archiving. Anyone who takes numerous screenshots on macOS – from developers documenting bugs to designers collecting inspiration or professionals managing digital receipts – will find immense value in Skreenshot. It dramatically reduces the time spent sifting through files, ensures important visual information is readily accessible, and helps maintain a clean, productive digital workspace. By integrating with built-in macOS tools and offering advanced features like OCR, it elevates screenshot management from a manual chore to an automated, intelligent process.
Best use case
The primary use case for Skreenshot is managing and organizing large volumes of screenshots on macOS, especially for users who frequently capture screen content and struggle with clutter and discoverability. It benefits professionals like developers, designers, project managers, and anyone needing to quickly retrieve, categorize, or clean up their digital visual records.
Organize, tag, search, and manage screenshots on macOS. Use when users need to: (1) find specific screenshots, (2) organize screenshots into folders by category/project, (3) search screenshot content via OCR, (4) bulk rename or move screenshots, (5) clean up old screenshots, or (6) integrate with CleanShot X or macOS screenshot tool.
Users should expect a significantly more organized macOS screenshot library, with files easily searchable, categorized, and readily accessible, reducing desktop clutter and improving productivity.
Practical example
Example input
Find all screenshots containing the word 'receipt' from the last month and move them to my 'receipts' folder.
Example output
Found 15 screenshots containing 'receipt'. Moved them from `~/Desktop` to `~/Pictures/Screenshots/receipts/`. For example: `~/Pictures/Screenshots/receipts/Screenshot 2023-10-26 at 11.30.05_receipt.png`.
When to use this skill
- When your macOS desktop is cluttered with unorganized screenshots.
- To quickly find specific screenshots based on content (via OCR) or date.
- To categorize and move screenshots into project-specific or thematic folders.
- To perform bulk operations like renaming or cleaning up old screenshot files.
When not to use this skill
- If you do not use macOS or do not take screenshots regularly.
- If you already use a dedicated, advanced screenshot management application that meets all your needs.
- For managing images that are not screenshots (e.g., photos, downloads).
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/skreenshot/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How Skreenshot Compares
| Feature / Agent | Skreenshot | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | medium | N/A |
Frequently Asked Questions
What does this skill do?
Organize, tag, search, and manage screenshots on macOS. Use when users need to: (1) find specific screenshots, (2) organize screenshots into folders by category/project, (3) search screenshot content via OCR, (4) bulk rename or move screenshots, (5) clean up old screenshots, or (6) integrate with CleanShot X or macOS screenshot tool.
How difficult is it to install?
The installation complexity is rated as medium. You can find the installation instructions above.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
Top AI Agents for Productivity
See the top AI agent skills for productivity, workflow automation, operational systems, documentation, and everyday task execution.
Best AI Skills for ChatGPT
Find the best AI skills to adapt into ChatGPT workflows for research, writing, summarization, planning, and repeatable assistant tasks.
AI Agents for Freelancers
Browse AI agent skills for freelancers handling client research, proposals, outreach, delivery systems, documentation, and repeatable admin work.
SKILL.md Source
# Skreenshot
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
```
Pictures/Screenshots/
├── client-acme/
├── client-globex/
└── personal/
```
### By Category
```
Pictures/Screenshots/
├── receipts/
├── bugs/
├── inspiration/
├── memes/
└── reference/
```
### By Date (auto-archive)
```
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 scriptsRelated Skills
find-skills
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
filesystem
Advanced filesystem operations for listing files, searching content, batch processing, and directory analysis. Supports recursive search, file type filtering, size analysis, and batch operations like copy/move/delete. Use when you need to: list directory contents, search for files by name or content, analyze directory structures, perform batch file operations, or analyze file sizes and distribution.
Budget & Expense Tracker — AI Agent Financial Command Center
Track every dollar, enforce budgets, spot spending patterns, and build wealth — all through natural conversation with your AI agent.
yt-dlp
A robust CLI wrapper for yt-dlp to download videos, playlists, and audio from YouTube and thousands of other sites. Supports format selection, quality control, metadata embedding, and cookie authentication.
time-checker
Check accurate current time, date, and timezone information for any location worldwide using time.is. Use when the user asks "what time is it in X", "current time in Y", or needs to verify timezone offsets.
pihole-ctl
Manage and monitor local Pi-hole instance. Query FTL database for statistics (blocked ads, top clients) and control service via CLI. Use when user asks "how many ads blocked", "pihole status", or "update gravity".
mermaid-architect
Generate beautiful, hand-drawn Mermaid diagrams with robust syntax (quoted labels, ELK layout). Use this skill when the user asks for "diagram", "flowchart", "sequence diagram", or "visualize this process".
memory-cache
High-performance temporary storage system using Redis. Supports namespaced keys (mema:*), TTL management, and session context caching. Use for: (1) Saving agent state, (2) Caching API results, (3) Sharing data between sub-agents.
mema
Mema's personal brain - SQLite metadata index for documents and Redis short-term context buffer. Use for organizing workspace knowledge paths and managing ephemeral session state.
file-organizer-skill
Organize files in directories by grouping them into folders based on their extensions or date. Includes Dry-Run, Recursive, and Undo capabilities.
media-compress
Compress and convert images and videos using ffmpeg. Use when the user wants to reduce file size, change format, resize, or optimize media files. Handles common formats like JPG, PNG, WebP, MP4, MOV, WebM. Triggers on phrases like "compress image", "compress video", "reduce file size", "convert to webp/mp4", "resize image", "make image smaller", "batch compress", "optimize media".
edge-tts
Text-to-speech conversion using node-edge-tts npm package for generating audio from text. Supports multiple voices, languages, speed adjustment, pitch control, and subtitle generation. Use when: (1) User requests audio/voice output with the "tts" trigger or keyword. (2) Content needs to be spoken rather than read (multitasking, accessibility, driving, cooking). (3) User wants a specific voice, speed, pitch, or format for TTS output.