Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Tencent SkillHub · Developer Tools
Spotlight
Search files and content using macOS Spotlight indexing (mdfind). Use when the user asks to search local files, documents, or directories on macOS. Supports...
skill openclawclawhub Free
Search files and content using macOS Spotlight indexing (mdfind). Use when the user asks to search local files, documents, or directories on macOS. Supports...
⬇ 0 downloads ★ 0 stars Unverified but indexed
Install for OpenClaw
Quick setup
- Download the package from Yavira.
- Extract the archive and review SKILL.md first.
- Import or place the package into your OpenClaw setup.
Package facts
- Download mode
- Yavira redirect
- Package format
- ZIP package
- Source platform
- Tencent SkillHub
- What's included
- SKILL.md, scripts/spotlight-search.sh
Validation
- Use the Yavira download entry.
- Review SKILL.md after the package is downloaded.
- Confirm the extracted package contains the expected setup assets.
Install with your agent
Agent handoff
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
New install
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
Upgrade existing
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Trust & source
Release facts
- Source
- Tencent SkillHub
- Verification
- Indexed source record
- Version
- 2.0.0
Provenance
- Publisher
- Li-Hongmin
- Source page
- View original listing
- Canonical URL
- Open canonical page
Documentation
Spotlight Search
Search local files using macOS Spotlight indexing system.
When to Use
Use this skill when: 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
Quick Start
scripts/spotlight-search.sh <directory> <query> [--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
Search Features
Fast: Uses system-level Spotlight index (no file scanning) Content-aware: Searches inside PDF, docx, txt, md, etc. Multilingual: Supports Chinese, Japanese, and all languages Metadata: Returns file path, type, and size
Output Format
🔍 Searching in /path/to/directory for: query ✅ Found N results (showing up to M): 📄 /full/path/to/file.pdf [pdf, 2.3M] 📄 /full/path/to/document.txt [txt, 45K] 📁 /full/path/to/folder/
Supported File Types
Spotlight automatically indexes: Text files (txt, md, csv, json, xml, etc.) Documents (pdf, docx, pages, rtf, etc.) Code files (py, js, java, c, etc.) Emails and contacts Images (with embedded metadata/OCR)
Limitations
macOS only: Requires Spotlight indexing Indexed directories only: External drives may not be indexed Keyword search: Not semantic (use embedding-based search for semantic queries) Privacy: Respects Spotlight privacy settings (excluded directories won't appear)
Check Indexing Status
# Check if a volume is indexed mdutil -s /path/to/volume # Enable indexing (requires admin) sudo mdutil -i on /path/to/volume
Integration with LLM Workflows
Pattern: Search + Extract + Summarize Use spotlight-search.sh to find relevant files Use read tool to extract content from top results Summarize or answer user's question based on extracted content Example workflow: User: "Find all documents about machine learning in my research folder" 1. Run: spotlight-search.sh ~/research "machine learning" --limit 10 2. Read top 3-5 results with read tool 3. Summarize findings for user
Advanced Query Syntax
Spotlight supports advanced query operators: # Exact phrase spotlight-search.sh ~/Documents "\"machine learning\"" # AND operator spotlight-search.sh ~/Documents "neural AND networks" # OR operator spotlight-search.sh ~/Documents "AI OR artificial intelligence" # Metadata queries spotlight-search.sh ~/Documents "kMDItemContentType == 'com.adobe.pdf'"
Troubleshooting
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)
Performance
Instant: Pre-indexed, no file scanning needed Scales well: Handles millions of files Low CPU: No processing overhead (vs grep/ripgrep) Comparison: ToolSpeedContent SearchMultilingualSpotlight⚡ Instant✅ Yes✅ Yesgrep/ripgrep🐢 Slow✅ Yes✅ Yesfind⚡ Fast❌ NoN/A
Platform Notes
macOS only: This skill requires macOS Spotlight Linux alternative: Use grep -r or ripgrep Windows alternative: Use Windows Search or Everything search
Category context
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Source: Tencent SkillHub
Largest current source with strong distribution and engagement signals.
Package contents
Included in package
1 Docs1 Scripts
- SKILL.md
- scripts/spotlight-search.sh