Is the Semantic Search (Beacon) skill free?

Yes. The skill itself is free from sagarmk/beacon-plugin. SkillProof publishes the install command and an independent test verdict at no cost.

What is the Semantic Search (Beacon) SkillProof Score?

7.6/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 5/10, docs & honesty 4/5.

How do I install Semantic Search (Beacon)?

Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.

Can I use Semantic Search (Beacon) with Cursor, Copilot, Gemini CLI, Codex or other AI tools?

The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.

Semantic Search (Beacon)

Hybrid semantic + BM25 code search that intercepts and redirects grep

by sagarmk · sagarmk/beacon-plugin

Works with setup

Install — copy the command Download source ↗

Test report

Verdict: Works with setup
Score: 7.6/10
Tested: Jul 17, 2026
Environment: Claude Code 2.x (agent harness)
Upstream re-checked: Aug 10, 2026 · 275e883

The scripts are clean (embeddings go to a configurable endpoint that defaults to local Ollama; the OpenAI/Voyage keys are the user's own env vars, disclosed in providers.json), so it is safe, but I could not demonstrate any search delta: with no Ollama and no API key, sync.js failed on an unreachable embedding endpoint and search.js reported 'no index found', so the index never built. Copied as a standalone skill it is also inert -- its search command points at a plugin-only path and its grep-intercept lives in a hook the skill copy does not carry, so it only works installed as the whole Beacon plugin against a live embedding server.

Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works

Installs cleanly 5/5
Triggers reliably 5/5
Output vs. baseline 5/10
Docs & honesty 4/5

What Semantic Search (Beacon) does

The search-facing skill of the Beacon plugin: a hybrid vector + BM25 + identifier-boost code index queried via a search.js script, with a hook that denies grep and redirects it to Beacon when the index is healthy. Triggers on code-navigation intent. Requires the full plugin (hooks, node deps) plus a running embedding backend (Ollama by default, or an OpenAI/Voyage API key).

How to install Semantic Search (Beacon)

git clone https://github.com/sagarmk/beacon-plugin
mkdir -p ~/.claude/skills
cd beacon-plugin && cp -r skills/semantic-search ~/.claude/skills/semantic-search

Skills live in ~/.claude/skills/ (global) or .claude/skills/ (per-project). Restart Claude Code after installing.

Commands — how to trigger Semantic Search (Beacon)

/semantic-search Hybrid semantic + BM25 code search that intercepts and redirects grep

It also activates on plain-language prompts like these:

Find where the authentication flow is implemented in this codebase.
Search my repo semantically for how the payment webhook is handled.
Build a code index so I can search by meaning instead of exact text.

Frequently asked questions

Is the Semantic Search (Beacon) skill free?: Yes. The skill itself is free from sagarmk/beacon-plugin. SkillProof publishes the install command and an independent test verdict at no cost.
Does Semantic Search (Beacon) work with Claude Code?: We tested it with Claude Code 2.x (agent harness) on Jul 17, 2026. Verdict: Works with setup. The scripts are clean (embeddings go to a configurable endpoint that defaults to local Ollama; the OpenAI/Voyage keys are the user's own env vars, disclosed in providers.json), so it is safe, but I could not demonstrate any search delta: with no Ollama and no API key, sync.js failed on an unreachable embedding endpoint and search.js reported 'no index found', so the index never built. Copied as a standalone skill it is also inert -- its search command points at a plugin-only path and its grep-intercept lives in a hook the skill copy does not carry, so it only works installed as the whole Beacon plugin against a live embedding server.
What is the Semantic Search (Beacon) SkillProof Score?: 7.6/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 5/10, docs & honesty 4/5.
How do I install Semantic Search (Beacon)?: Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
Can I use Semantic Search (Beacon) with Cursor, Copilot, Gemini CLI, Codex or other AI tools?: The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.