fmql-semantic

Index and search markdown notes with semantic retrieval via LiteLLM embeddings.

17|1|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/buyuk-dev/fmql --skill fmql-semantic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fmql-semantic
Source: https://github.com/buyuk-dev/fmql/tree/main/packages/fmql-semantic/skills/fmql-semantic
Command: npx skills add https://github.com/buyuk-dev/fmql --skill fmql-semantic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enable semantic retrieval over a directory of markdown/frontmatter notes, returning relevant results by meaning rather than exact keywords.

Core Features & Use Cases

  • Hybrid dense + sparse retrieval, combining LiteLLM embeddings and BM25 for robust results.
  • End-to-end workflow: index with fmql index using the semantic backend, then search with fmql search.
  • Optional reranking and model pinning for higher precision in top-k results.

Quick Start

Index a workspace with the semantic backend and then search semantically.

Frequently Asked Questions about fmql-semantic

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

FAQPage Schema
How do I do semantic search over markdown notes?

You can enable semantic search over markdown notes by running fmql index --backend semantic on your vault directory, then using fmql search --backend semantic to retrieve documents by meaning rather than exact keywords.

What is hybrid dense and sparse retrieval for a notes vault?

Hybrid dense and sparse retrieval combines LiteLLM embeddings with BM25 search to return relevant notes from a vault. This approach ensures robust results by matching both semantic meaning and exact keywords.

Do I need a LiteLLM embedding model to index markdown documentation?

Yes, you need a LiteLLM-compatible embedding model and configured API keys via environment variables to index markdown documentation. The semantic backend relies on these to generate vector embeddings for your notes.

Can I cluster topics across personal knowledge bases?

You can apply topic clustering and context-aware retrieval across personal knowledge bases using the semantic backend. It processes directories of markdown and frontmatter notes to group related topics meaningfully.

How do I improve top-k precision in semantic search results?

You can improve top-k precision in semantic search results by enabling optional reranking and model pinning. These features refine the initial hybrid retrieval output for higher accuracy in the returned documents.

Does semantic retrieval work with frontmatter notes?

Semantic retrieval works directly with markdown and frontmatter notes. The indexing process parses frontmatter metadata alongside text content to ensure context-aware search across your workspace.