Skill

qmd-setup

Sets up @tobilu/qmd for semantic search over mnemonic memories: registers collections from MNEMONIC_ROOT, builds indexes with qmd update, generates embeddings. One-time per-machine bootstrap.

Bash

Node

ai-ml

developer-tools

Install

npx claudepluginhub zircote/mnemonic

Tool Access

This skill is limited to using the following tools:

BashReadWrite

Preview

Bootstrap `@tobilu/qmd` for semantic search over mnemonic memories.

SKILL.md

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

139.0k

claude-opus-4-5-migration

2 files

Migrates code, prompts, and API calls from Claude Sonnet 4.0/4.5 or Opus 4.1 to Opus 4.5, updating model strings on Anthropic, AWS, GCP, Azure platforms.

claude-opus-4-5-migration

83.2k

bmad-help

Analyzes BMad project state from catalog CSV, configs, artifacts, and query to recommend next skills or answer questions. Useful for help requests, 'what next', or starting BMad.

bmad-pro-skills

43.8k

Stats

Stars11

Forks3

Last CommitFeb 18, 2026

Actions

View Source View Plugin View on GitHub View README

QMD Setup Skill

Bootstrap @tobilu/qmd for semantic search over mnemonic memories.

Prerequisites

Node.js >= 22 — node --version
qmd CLI — npm i -g @tobilu/qmd

Automated Setup

Run the setup script:

bash tools/qmd-setup.sh

The script will:

Check prerequisites (Node.js >= 22, qmd installed)
Resolve MNEMONIC_ROOT from ~/.config/mnemonic/config.json
Discover memory roots dynamically:
- {MNEMONIC_ROOT}/{org}/ → collection mnemonic-{org}
- {MNEMONIC_ROOT}/default/ → collection mnemonic-default
- .claude/mnemonic/ → collection mnemonic-project
Run qmd update (index) + qmd embed (embeddings)
Validate with qmd status and a test search

Note: First qmd embed downloads ~2 GB of GGUF models.

Manual Setup

If you prefer to set up manually:

MNEMONIC_ROOT is resolved from ~/.config/mnemonic/config.json (defaults to ~/.local/share/mnemonic). Adjust the paths below to match your config:

# 1. Register collections (replace paths with your MNEMONIC_ROOT)
qmd collection add "${MNEMONIC_ROOT:-$HOME/.local/share/mnemonic}/zircote/" --name mnemonic-zircote
qmd collection add "${MNEMONIC_ROOT:-$HOME/.local/share/mnemonic}/default/" --name mnemonic-default
qmd collection add "$(git rev-parse --show-toplevel)/.claude/mnemonic/" --name mnemonic-project  # if exists

# 2. Build index
qmd update

# 3. Generate embeddings (downloads models on first run)
qmd embed

# 4. Validate
qmd status
qmd search "test" -n 3

After Setup

Use search commands:

Command	Type	Requires
`qmd search "query"`	BM25 keyword	`qmd update`
`qmd vsearch "query"`	Semantic vector	`qmd embed`
`qmd query "query"`	Hybrid (BM25 + vector)	Both

Scope to a specific collection:

qmd search "auth" -c mnemonic-zircote    # org memories only
qmd search "auth" -c mnemonic-project    # this repo only
qmd search "auth"                        # all collections

Re-indexing

After adding new memories, re-index with /mnemonic:qmd-reindex or:

qmd update && qmd embed

Indexing is not automatic — run after captures or bulk imports.