Skip to content
Back to skills

Qmd

ASecurity

On-device search over markdown notes, docs, meeting transcripts and memory files, with BM25, vector search and local re-ranking, via the MIT qmd CLI and MCP server. Use when the user wants to search their notes or a docs folder, or when /ccc-recall or /ccc-knowledge needs a real search index.

  • 6 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 18, 2026
ai-agentsshellbashnodegit

Works with

  • claude code
  • cli
  • mcp

Security analysis

A96/100
  • mediumInstalls packages at runtime which could introduce malicious dependencies

Pro shows the line behind each finding and how to fix it

Scanned November 18, 2026

npx -y skills add KevinZai/commander --skill qmd --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Qmd?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Qmd
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/kevinzai-qmd/badge)](https://www.skillsdirectory.com/skills/kevinzai-qmd)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: qmd
description: "On-device search over markdown notes, docs, meeting transcripts and memory files, with BM25, vector search and local re-ranking, via the MIT qmd CLI and MCP server. Use when the user wants to search their notes or a docs folder, or when /ccc-recall or /ccc-knowledge needs a real search index."
tags: [search, knowledge, memory, mcp, local-first]
---

# qmd search

Opt-in add-on. [tobi/qmd](https://github.com/tobi/qmd) (MIT) indexes markdown collections and searches them with BM25 full-text search, vector search and LLM re-ranking, all running locally through node-llama-cpp with GGUF models. It works from the command line and as an MCP server (`qmd mcp`).

## Install

Claude Code plugin (recommended upstream):

Install from the upstream README, reviewed at [`aa247d0`](https://github.com/tobi/qmd/tree/aa247d0ee2e5dc3b83e1270714c0f06ca94e2514#readme). CCC safety: the plugin marketplace serves the current upstream revision, not the reviewed one. Before installing, confirm the marketplace source is `github.com/tobi/qmd` itself and not a same-named plugin from another publisher, and tell the user if upstream has changed since `aa247d0`.

CLI and MCP only (macOS and Linux; on native Windows the npm global bin layout differs, so follow the upstream README there):

```bash
# One errexit subshell, run on its own: a failed install stops before registration,
# and the server is registered by the absolute path of the binary just installed.
( set -euo pipefail
  npm install -g @tobilu/qmd@2.9.0          # pinned; fails if that version is unavailable
  prefix="$(npm prefix -g)"             # its own statement, so a failed lookup stops here
  case "$prefix" in /?*) ;; *) echo "stop: no npm global prefix"; exit 1;; esac
  qmd="$prefix/bin/qmd"
  [ -x "$qmd" ]
  "$qmd" --version
  claude mcp add qmd -- "$qmd" mcp
)
```
 Check first with `claude mcp list` and `claude plugin list`.

## When to route here

- `/ccc-recall` or `/ccc-knowledge` is asked to find something across many notes, and grep is not enough.
- The user keeps an Obsidian vault, a `docs/` tree, or the `memory/` directory from `/ccc-memory` and wants natural-language search over it.

## Limits

- The first query downloads GGUF models (hundreds of MB). Say so before the first search, and never start it on a metered or offline machine (`CCC_OFFLINE=1`).
- With the default local models, indexing and search stay on the device. CCC safety: if the qmd config points embeddings or re-ranking at a remote endpoint, document chunks and queries leave the machine; tell the user and ask before indexing.

## Next step

- 🟢 Install: walks through the pinned install above, with your OK
- Local only: sets qmd up without remote embeddings
- Pick another skill: `/ccc-suggest` recommends one
- Done: you continue manually

## License

MIT, see the upstream repository.

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.