Skreenshot

v0.0.1

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

0· 165·0 current·0 all-time
byX@10oss
MIT-0
Download zip
LicenseMIT-0 · Free to use, modify, and redistribute. No attribution required.
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
Purpose & Capability
The name/description (organize, rename, archive, OCR-search screenshots) matches the included scripts and docs. The Python scripts operate only on user file paths (~/Desktop, ~/Pictures/Screenshots) and perform renaming/moving; referenced OCR tools (textsnip, EasyOCR) are reasonable optional dependencies for the described OCR search feature.
Instruction Scope
SKILL.md instructs the agent/user to list, rename, move, archive screenshots and to run OCR tools. It also shows a 'defaults write com.apple.screencapture location' command which changes a macOS system setting (expected for this purpose). The docs recommend adding cron jobs, Hazel rules, and shell aliases which extend the skill's effects persistently on the host—these are in-scope but are system-modifying and should be applied only with user consent. The README assumes third-party tools may be installed but does not install them automatically.
Install Mechanism
No install spec is provided (instruction-only plus two small scripts). Nothing is downloaded or executed from external URLs by the skill itself. The scripts are small, readable, and perform only local filesystem operations.
Credentials
The skill requests no environment variables or credentials. The scripts only access user file paths. Note: running OCR or moving files may require macOS filesystem permissions (e.g., Desktop/Pictures access or Full Disk Access) and installing third-party OCR tools via Homebrew/pip is required if the user wants those features.
Persistence & Privilege
The skill itself is not permanently enabled (always:false) and does not request elevated platform privileges. However, the documentation suggests adding cron entries, Hazel automation rules, and shell aliases which create persistent behaviors on the host. This is expected for an automation tool but worth highlighting as a user action that persists outside the agent.
Assessment
This skill appears to do exactly what it says: local renaming and archiving of macOS screenshots and guidance for using OCR. Before running anything, review the two Python scripts locally and run them with --dry-run first. Be aware the README shows a 'defaults write com.apple.screencapture' command that will change where macOS saves screenshots—only run it if you want that change. If you enable scheduled automation (crontab, Hazel) or add shell aliases, those actions will persist on your machine and run without further prompts. Install third‑party OCR tools (textsnip, EasyOCR) only from trusted sources; macOS may request filesystem permissions to access Desktop/Pictures. Also check the example cron path (~/Documents/Skreenshot) matches where you store the skill files before enabling automation.

Like a lobster shell, security has layers — review code before you run it.

latestvk97brfcke5zd6p7c7s0qyze3qd82vw7x

License

MIT-0
Free to use, modify, and redistribute. No attribution required.

Comments