spotlight_search

Search macOS files and documents by name, content, type, or date using Spotlight's mdfind.

29|1|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/spamsch/son-of-simon --skill spotlight-search-spamsch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spotlight_search
Source: https://github.com/spamsch/son-of-simon/tree/main/skills/spotlight_search
Command: npx skills add https://github.com/spamsch/son-of-simon --skill spotlight-search-spamsch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of quickly locating files and documents on your Mac by leveraging the power of macOS Spotlight.

Core Features & Use Cases

  • Fast File Search: Utilizes macOS Spotlight to perform lightning-fast searches across your entire disk.
  • Flexible Search Options: Search by file name, content, type, or date with various options to refine your search.
  • Recent File Tracking: Find files you've recently worked on with ease.

Quick Start

Use the spotlight_search skill to find all PDFs on your Mac modified in the last 7 days.

Frequently Asked Questions about spotlight_search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for files on my Mac using Spotlight?

To search for files on your Mac using Spotlight, you can query by file name, content, type, or date. This leverages macOS mdfind to perform lightning-fast retrievals across your entire disk.

Can I find recently modified documents on macOS?

Yes, you can find recently modified documents on macOS by filtering file searches based on date. This allows you to quickly locate files you've worked on within a specific recent timeframe.

Does file search work for specific file types like PDFs?

Yes, macOS file search supports filtering by specific file types like PDFs. You can refine your query to return only documents matching a designated kind, such as PDFs modified in the last 7 days.

How does macOS Spotlight handle content searches?

macOS Spotlight handles content searches by indexing file data across your disk, allowing you to query the actual text inside documents. This delivers fast file retrieval based on internal content matches.

What is the best way to locate files for administrative workflows on a Mac?

The best way to locate files for administrative workflows on a Mac is using Spotlight's mdfind. It is optimized for efficient file retrieval, allowing you to search by name, content, type, and date instantly.

Are there limitations to searching files with macOS mdfind?

A limitation of searching files with macOS mdfind is that it relies entirely on the existing Spotlight index. If a file location or type is excluded from Spotlight's indexing settings, it will not appear in search results.