How do I install the Semantic Search skill?

Run npx skillmds@latest add ansellwaxlike187/semantic-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 Semantic Search safe to use?

SkillMD's automated safety review verdict for this skill is PASS. 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 Semantic 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 Semantic Search free to use?

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

Who published Semantic Search?

Ansellwaxlike187 (@ansellwaxlike187) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Semantic Search by ansellwaxlike187

Name: Semantic Search
Author: Ansellwaxlike187

Semantic Search

Search local document folders using natural language. Use when the user asks about content in their files, references documents they've mentioned before, asks "what does the report say about...", "find the document about...", "was ist in dem Dokument uber...", or when they need to locate information across many files. Also use when the user asks to index or search a folder of documents.

File contents

Semantic Document Search

Search across locally indexed document folders using natural language queries. Supports Markdown and text files (PDF, Word, PowerPoint coming in Phase 2).

When to Use

Search automatically when the user:

Asks about content that likely lives in their documents
References reports, notes, emails, or files by topic
Says things like "find...", "what did ... say about...", "where is the info about..."
Uses German phrases like "was steht in...", "finde das Dokument uber...", "was sagt der Bericht zu..."
Asks to compare information across multiple documents

Index first when the user:

Mentions a folder of documents they want to search
Says "index my documents", "make these searchable"
References a folder that hasn't been indexed yet

Workflow

First-time setup

Ask which folder(s) the user wants to make searchable
Call index_folder with the folder path
Report results: how many files indexed, any failures
Confirm they can now search with natural language

Searching

Call semantic_search with the user's query
If results are found:
- Synthesize an answer from the most relevant chunks
- Always cite the source file and page number (if PDF)
- Quote relevant passages when helpful
- Mention the relevance score only if the user asks about confidence
If no results:
- Suggest indexing the relevant folder
- Suggest rephrasing the query or broadening search terms

Presenting results

Lead with the answer, not the search mechanics
Cite sources naturally: "According to Q3-report.pdf (page 12)..."
For German queries, respond in German with source citations
If multiple documents are relevant, synthesize across them
Offer to show more results or search with different terms

Important Notes

The search works in both English and German (and 48 other languages)
Documents must be indexed before they can be searched
Indexing is incremental — only changed files are re-processed
Large folders (1000+ files) may take a few minutes to index initially

---name: semantic-searchdescription: Search local document folders using natural language. Use when the user asks about content in their files, references documents they've mentioned before, asks "what does the report say about...", "find the document about...", "was ist in dem Dokument uber...", or when they need to locate information across many files. Also use when the user asks to index or search a folder of documents.---# Semantic Document SearchSearch across locally indexed document folders using natural language queries.Supports Markdown and text files (PDF, Word, PowerPoint coming in Phase 2).## When to Use**Search automatically** when the user:- Asks about content that likely lives in their documents- References reports, notes, emails, or files by topic- Says things like "find...", "what did ... say about...", "where is the info about..."- Uses German phrases like "was steht in...", "finde das Dokument uber...", "was sagt der Bericht zu..."- Asks to compare information across multiple documents**Index first** when the user:- Mentions a folder of documents they want to search- Says "index my documents", "make these searchable"- References a folder that hasn't been indexed yet## Workflow### First-time setup1. Ask which folder(s) the user wants to make searchable2. Call `index_folder` with the folder path3. Report results: how many files indexed, any failures4. Confirm they can now search with natural language### Searching1. Call `semantic_search` with the user's query2. If results are found: - Synthesize an answer from the most relevant chunks - Always cite the source file and page number (if PDF) - Quote relevant passages when helpful - Mention the relevance score only if the user asks about confidence3. If no results: - Suggest indexing the relevant folder - Suggest rephrasing the query or broadening search terms### Presenting results- Lead with the answer, not the search mechanics- Cite sources naturally: "According to Q3-report.pdf (page 12)..."- For German queries, respond in German with source citations- If multiple documents are relevant, synthesize across them- Offer to show more results or search with different terms## Important Notes- The search works in both English and German (and 48 other languages)- Documents must be indexed before they can be searched- Indexing is incremental — only changed files are re-processed- Large folders (1000+ files) may take a few minutes to index initially

Frequently asked questions