← 返回 Skills 市场
Spotlight
作者
HONGMIN LI
· GitHub ↗
· v2.1.0
· MIT-0
681
总下载
0
收藏
2
当前安装
5
版本数
在 OpenClaw 中安装
/install 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...
安全使用建议
This skill appears to do what it says: a simple local Spotlight search helper. Before installing, ensure you'll run it on macOS (mdfind must be available), and be aware it will return full file paths from directories you specify — do not ask the agent to automatically open/read files without confirming with you first. Also note the registry metadata could be improved to declare macOS as the required platform and to document the dependency on mdfind/mdutil.
功能分析
Type: OpenClaw Skill
Name: spotlight
Version: 2.1.0
The skill is a legitimate wrapper for the macOS Spotlight search utility (mdfind). The bash script (scripts/spotlight-search.sh) safely handles directory scoping and result limiting without any evidence of data exfiltration, persistence, or malicious execution. Furthermore, SKILL.md includes proactive security instructions for the AI agent, such as requiring user confirmation before reading files and explicitly forbidding unauthorized sudo commands.
能力评估
Purpose & Capability
The skill's name/description and included script consistently implement macOS Spotlight searches (uses mdfind -onlyin). Minor inconsistency: the registry metadata does not declare an OS restriction or required binaries, but the script requires macOS tools (mdfind) to work. This is an implementation/metadata omission rather than a functional mismatch.
Instruction Scope
SKILL.md instructs the agent to run the provided script, present file paths, and only read file contents with explicit user permission. The script itself only enumerates Spotlight results from a user-specified directory and prints paths/types/sizes — it does not read file contents, call remote endpoints, or access unrelated system files. It does print full file paths (which can reveal sensitive locations) but that is expected for a search tool and is emphasized in the documentation.
Install Mechanism
No install spec; this is instruction-only with an included shell script. No downloads or external installers are invoked. Risk from installation is minimal because nothing is written/downloaded automatically.
Credentials
The skill requests no environment variables, credentials, or config paths. This is proportional to its function. Note: because it outputs full file paths, using it will surface local path information — the SKILL.md appropriately instructs to obtain user consent before reading files.
Persistence & Privilege
always:false and no special privileges are requested. The skill does not attempt to persist, modify other skills, or require elevated privileges. The documentation explicitly warns against running sudo commands.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install spotlight - 安装完成后，直接呼叫该 Skill 的名称或使用
/spotlight触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v2.1.0
Security fix
v2.0.0
Clean release: English UI, privacy protection, external drive support, SIGPIPE fix
v1.0.2
Remove Chinese comments and examples; Use English for all output messages; Remove privacy-sensitive example paths
v1.0.1
Fix SIGPIPE error when using head with large result sets; Add support for external drives search
v1.0.0
- Initial release of the Spotlight skill for macOS local file and content search using Spotlight indexing (mdfind).
- Supports fast searching inside PDFs, Word documents, text files, and more, including multilingual content.
- Includes quick start instructions, output formatting, and advanced Spotlight query syntax.
- Documents integration into LLM workflows (search + extract + summarize pattern).
- Notes limitations (macOS only, indexed directories required) and troubleshooting tips.
元数据
常见问题
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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 681 次。
如何安装 Spotlight？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install spotlight」即可一键安装，无需额外配置。
Spotlight 是免费的吗？
是的，Spotlight 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Spotlight 支持哪些平台？
Spotlight 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Spotlight？
由 HONGMIN LI（@li-hongmin）开发并维护，当前版本 v2.1.0。
推荐 Skills