Skreenshot

What This Skill Does

The Skreenshot skill is a powerful utility designed to transform the messy, cluttered default behavior of macOS screenshots into a structured, searchable, and manageable library. By default, macOS dumps every screenshot onto the Desktop, leading to file fragmentation and 'desktop-clutter anxiety.' Skreenshot provides the orchestration layer to automatically detect new screenshots, move them to categorized directory structures, apply intelligent renaming conventions based on dates and user-defined tags, and perform full-text content extraction via OCR. It effectively turns your screenshot collection into a searchable database rather than a pile of nameless PNG files.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/10sk/skreenshot

Once installed, ensure your system has access to standard OCR dependencies if you intend to use advanced text-based searching beyond the native macOS capabilities. The skill manages its own internal path configurations for screenshot storage, allowing you to redirect the default output of the macOS capture daemon to your preferred organized folder structure.

Use Cases

This skill is indispensable for professionals who capture frequent visual feedback. Common use cases include: managing client-specific documentation screenshots, organizing UI/UX bugs for dev reports, archiving financial receipts, and maintaining a library of design inspirations. By leveraging the OCR capabilities, you can quickly find that 'one screenshot' from three months ago that contained a specific error code or login detail without having to manually preview hundreds of image files.

Example Prompts

1. "Skreenshot, find the screenshot I took last week that contains the error message 'Database Connection Failed' and move it to the /bugs/active folder."
2. "Organize all screenshots currently on my Desktop from this month into a new folder named /project-alpha/ and rename them using the format: ProjectAlpha_YYYY-MM-DD_HHMM.png."
3. "Clean up my Desktop by moving all screenshots older than 30 days into the /archive/2026 folder and keep the most recent ones organized by category."

Tips & Limitations

For the best results, configure your macOS system capture location to a dedicated folder that the Skreenshot skill monitors. While OCR functionality is highly effective, the speed of searching scales with the number of files; consider archiving older screenshots to maintain peak performance. Integration with tools like CleanShot X is supported, allowing you to bypass the default system screenshot behavior entirely for a smoother workflow. Always verify that your file permissions allow the agent to write to your chosen directory structures.