← Back to Skills Marketplace
385
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install local-image-search
Description
Fast local image search using macOS Spotlight or fd. Search images by name, date, location, or metadata. Use when users need to find images on their local ma...
README (SKILL.md)
Local Image Search
Search local images quickly using macOS Spotlight or fd.
Quick Start
Search by Name
# Using fd (fastest)
fd -e jpg -e png -e jpeg -e heic -e webp -e gif -e tiff "pattern" /path/to/search
# Using Spotlight
mdfind -onlyin /path/to/search "kMDItemDisplayName == '*pattern*'"
Search by Date
# Today
mdfind -onlyin ~/Pictures "kMDItemContentTypeTree == 'public.image' && kMDItemFSContentChangeDate > $time.today()"
# Last 7 days
mdfind -onlyin ~/Pictures "kMDItemContentTypeTree == 'public.image' && kMDItemFSContentChangeDate > $time.now(-604800)"
# This month
mdfind -onlyin ~/Pictures "kMDItemContentTypeTree == 'public.image' && kMDItemFSContentChangeDate > $time.this_month()"
Search by Location (GPS)
# Has GPS coordinates
mdfind "kMDItemContentTypeTree == 'public.image' && kMDItemGPSStatus == 'GPS'"
# In specific area (approximate)
mdfind "kMDItemContentTypeTree == 'public.image' && kMDItemGPSLatitude > 39 && kMDItemGPSLatitude \x3C 41"
List All Images
# All images in home
mdfind "kMDItemContentTypeTree == 'public.image'"
# Specific directory only
mdfind -onlyin ~/Pictures "kMDItemContentTypeTree == 'public.image'"
# Specific types only
mdfind -onlyin ~/Pictures "kMDItemContentType == 'public.png'"
Available Scripts
Basic Search
scripts/search_by_name.sh- Search images by filename patternscripts/search_by_date.sh- Search by creation/modification datescripts/list_all.sh- List all images in a directory
Advanced Search
scripts/search_by_location.sh- Search by GPS coordinatesscripts/search_by_size.sh- Search by image dimensionsscripts/search_similar.sh- Find visually similar images (requires perceptual hash)
Utility
scripts/thumbnail.sh- Generate thumbnails for resultsscripts/copy_results.sh- Copy search results to destination
Image Types Supported
| Extension | Type |
|---|---|
| jpg/jpeg | JPEG images |
| png | PNG images |
| heic | iPhone photos |
| webp | WebP images |
| gif | GIF images |
| tiff | TIFF images |
| raw | RAW camera files |
| dng | Digital negatives |
Metadata Search Keys
| Key | Description |
|---|---|
| kMDItemDisplayName | Filename |
| kMDItemFSContentChangeDate | Modification date |
| kMDItemContentCreationDate | Creation date |
| kMDItemPixelWidth | Image width |
| kMDItemPixelHeight | Image height |
| kMDItemGPSLatitude | GPS latitude |
| kMDItemGPSLongitude | GPS longitude |
| kMDItemMake | Camera make |
| kMDItemModel | Camera model |
Examples
# Find all screenshots
./scripts/search_by_name.sh "Screen Shot" ~/Desktop
# Find photos from today
./scripts/search_by_date.sh today ~/Pictures
# Find iPhone photos
./scripts/search_by_name.sh "IMG_" ~/Pictures
# Copy results to folder
./scripts/search_by_date.sh today ~/Pictures | ./scripts/copy_results.sh ~/Desktop/today_photos
Requirements
- macOS (uses Spotlight/mdfind)
- fd (optional, for faster filename search):
brew install fd - exiftool (optional, for advanced metadata):
brew install exiftool
Usage Guidance
This skill appears coherent and focused on local image searches. Before use: (1) Verify you're on macOS and that you understand the directory you point the scripts at (they will enumerate image files and copy files if you run copy_results.sh). (2) Inspect the scripts yourself (they're short and plain shell) and run them first on a test folder to confirm behavior. (3) Be aware that GPS/metadata queries will surface location data from your photos — treat results as sensitive. (4) Note small inconsistencies: some scripts mentioned in SKILL.md are missing, and the mdfind time expressions may need adjusting for your macOS version. If you need stronger assurances, run the scripts in a constrained environment or with test data first.
Capability Analysis
Type: OpenClaw Skill
Name: local-image-search
Version: 1.0.0
The skill bundle provides scripts for local image search and management, using standard macOS utilities like `mdfind` and `fd`. All shell scripts properly quote user-provided arguments (`"$VAR"`), mitigating shell injection risks. The `SKILL.md` file contains no prompt injection attempts or instructions for the agent to perform actions outside the stated purpose. While the scripts have broad file system access (searching and copying files), this is inherent to their stated function and there is no evidence of malicious intent such as data exfiltration, persistence mechanisms, or unauthorized remote communication.
Capability Assessment
Purpose & Capability
Name/description describe local image search and the included scripts and SKILL.md only perform filesystem queries (mdfind/find/fd), metadata inspection, and file copying which are consistent with that purpose.
Instruction Scope
Runtime instructions and scripts are narrowly scoped to searching and copying image files. There are a few minor inconsistencies: SKILL.md mentions additional scripts (search_by_size.sh, search_similar.sh, thumbnail.sh) that are not present in the package, and the mdfind examples use $time.*() expressions which may not be valid mdfind syntax on all macOS versions — this is a functionality issue, not a security red flag. The scripts only operate on user-specified directories and do not read unrelated system files or environment variables.
Install Mechanism
No install spec is provided (instruction-only with small helper scripts). Nothing is downloaded or written by an installer, minimizing persistence and supply-chain risk.
Credentials
The skill requires no environment variables, credentials, or config paths. Optional external tools (fd, exiftool) are reasonable for performance/metadata enhancements and are documented as optional.
Persistence & Privilege
always is false and the skill does not request elevated or persistent privileges or modify other skills or system-wide configs. Scripts only perform file reads and optional file copies to destinations you provide.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install local-image-search - After installation, invoke the skill by name or use
/local-image-search - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Fast local image search using Spotlight or find command
Metadata
Frequently Asked Questions
What is Local Image Search?
Fast local image search using macOS Spotlight or fd. Search images by name, date, location, or metadata. Use when users need to find images on their local ma... It is an AI Agent Skill for Claude Code / OpenClaw, with 385 downloads so far.
How do I install Local Image Search?
Run "/install local-image-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Local Image Search free?
Yes, Local Image Search is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Local Image Search support?
Local Image Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Local Image Search?
It is built and maintained by 匠心 (@zhaomenghuan); the current version is v1.0.0.
More Skills