Spotlight by @li-hongmin
Search files and content using macOS Spotlight indexing (mdfind). Use when the user asks to search local files, documents, or directories on macOS. Supports...
β‘ When to Use
Trigger Action - User asks to search files or directories on macOS - Need to find documents containing specific text - Searching large document collections (faster than grep) - Need to search inside PDFs, Word docs, or other indexed formats
π‘ Examples
scripts/spotlight-search.sh [--limit N]
Examples:
scripts/spotlight-search.sh ~/Documents "machine learning"
scripts/spotlight-search.sh ~/research "neural networks" --limit 10
scripts/spotlight-search.sh ~/Downloads "meeting notes" --limit 5
π Tips & Best Practices
No results found:
Check if directory is indexed: mdutil -s /path
Wait for indexing to complete (new files may take minutes)
Verify Spotlight is enabled in System Preferences Incorrect results:
Spotlight uses fuzzy matching and synonyms
Use exact phrase search: "exact phrase"
Check privacy settings (some folders may be excluded) βΈ Show full description clawhub install spotlightCopy
π§ͺ Use this skill with your agent Most visitors already have an agent. Pick your environment, install or copy the workflow, then run the smoke-test prompt above.
π Can't find the right skill?
Search 60,000+ AI agent skills β free, no login needed.
Search Skills β 