Skip to content
TakoAPI
Back to skills

spotlight

by li-hongmin

Coding Agents & IDEs
356Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Search files and content using macOS Spotlight indexing (mdfind)

Description

What This Skill Does

Searches local files and directories on macOS using the Spotlight index via mdfind. Finds text content inside PDFs, Word documents, markdown files, code, and other indexed formats. Only works on macOS with Spotlight enabled.

Uses macOS's pre-built Spotlight index so searches return instantly without scanning files, unlike grep or ripgrep which must read every file.

When to Use It

  • Find all PDFs mentioning a specific project name in Downloads
  • Search research folder for papers containing a technical term
  • Locate meeting notes across multiple directories
  • Find code files referencing a function or variable name
  • Search documents in multiple languages without extra setup

Example Workflow

INPUT

User asks: 'Find all documents about machine learning in my research folder'

AGENT
  1. 1

    Run spotlight-search.sh ~/research "machine learning" --limit 10

  2. 2

    Receive list of matching file paths with types and sizes

  3. 3

    Read content from the top 3-5 results using the read tool

  4. 4

    Synthesize findings into a summary for the user

OUTPUT

A summary of relevant documents found, with file paths and key content excerpts

Installation

clawhub install li-hongmin/spotlight

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links