How do I install the Local Search skill?

Run npx skillmds@latest add tomevault-io/local-search in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Local Search safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Local Search?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Local Search free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Local Search?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Local Search by tomevault-io — Agent Skill

Name: Local Search
Author: tomevault-io

File contents

本地文件搜索

在用户电脑上搜索文件内容和文件名。

使用场景

用户说「帮我找一下上次写的报告」「搜一下包含 XXX 的文件」
用户需要查找特定文件但不记得存在哪里
任务执行中需要定位参考文件

搜索方式

方式 1：knowledge_search 工具（内容搜索，首选）

搜索已索引知识库中的文档内容。支持 FTS5 全文搜索和语义搜索。

工具名: knowledge_search

参数:
  query:     搜索查询（自然语言），必填
  limit:     返回结果数量，默认 5
  file_type: 过滤文件类型（如 .md, .txt, .pdf），可选

方式 2：mdfind（文件名搜索，补充）

knowledge_search 无结果时，用 macOS Spotlight 按文件名或元数据搜索。

# 按文件名搜索
mdfind -name "报告"

# 限定目录
mdfind -onlyin ~/Documents "预算"

# 限定文件类型
mdfind "kind:pdf 合同"
mdfind "kind:word 报告"

搜索策略

优先用 knowledge_search：覆盖已索引的知识库文件，支持内容搜索和语义匹配
knowledge_search 无结果时用 mdfind：按文件名或元数据搜索，覆盖面更广
两者都无结果时：告知用户，询问是否需要将目标目录加入知识库索引

输出规范

展示搜索结果，包含文件路径和摘要片段
路径用 ~ 简写用户目录
告知用户总共找到多少结果
结果过多时询问用户是否要进一步筛选

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: local-searchdescription: Search user's local knowledge base and files using the knowledge_search tool (FTS5 + semantic) and macOS Spotlight (mdfind) for filename lookup. Use when this capability is needed.---# 本地文件搜索在用户电脑上搜索文件内容和文件名。## 使用场景- 用户说「帮我找一下上次写的报告」「搜一下包含 XXX 的文件」- 用户需要查找特定文件但不记得存在哪里- 任务执行中需要定位参考文件## 搜索方式### 方式 1：knowledge_search 工具（内容搜索，首选）搜索已索引知识库中的文档内容。支持 FTS5 全文搜索和语义搜索。```工具名: knowledge_search参数: query: 搜索查询（自然语言），必填 limit: 返回结果数量，默认 5 file_type: 过滤文件类型（如 .md, .txt, .pdf），可选```<example><query>帮我找一下之前写的季度总结</query><action>调用 knowledge_search，参数：{"query": "季度总结"}</action><reasoning>用户要搜索文档内容，knowledge_search 覆盖已索引文件，优先使用</reasoning></example><example><query>搜一下包含"预算审批"的 PDF 文件</query><action>调用 knowledge_search，参数：{"query": "预算审批", "file_type": ".pdf"}</action><reasoning>有明确的文件类型过滤需求，使用 file_type 参数</reasoning></example><example><query>我上传的产品文档里有没有提到竞品分析？</query><action>调用 knowledge_search，参数：{"query": "竞品分析"}</action><reasoning>搜索已索引文档中的特定内容</reasoning></example>### 方式 2：mdfind（文件名搜索，补充）knowledge_search 无结果时，用 macOS Spotlight 按文件名或元数据搜索。```bash# 按文件名搜索mdfind -name "报告"# 限定目录mdfind -onlyin ~/Documents "预算"# 限定文件类型mdfind "kind:pdf 合同"mdfind "kind:word 报告"```## 搜索策略1. **优先用 knowledge_search**：覆盖已索引的知识库文件，支持内容搜索和语义匹配2. **knowledge_search 无结果时用 mdfind**：按文件名或元数据搜索，覆盖面更广3. **两者都无结果时**：告知用户，询问是否需要将目标目录加入知识库索引## 输出规范- 展示搜索结果，包含文件路径和摘要片段- 路径用 `~` 简写用户目录- 告知用户总共找到多少结果- 结果过多时询问用户是否要进一步筛选---> Converted and distributed by [TomeVault](https://tomevault.io/claim/malue-ai) — claim your Tome and manage your conversions.

Frequently asked questions

Local Search