Przejdź do treści
Biblioteka skilli
Produktywność osobista · Research

qmd

/qmd

Przeszukuje bazy wiedzy w Markdown, notatki i dokumentację za pomocą QMD, aby znaleźć dokumenty i informacje.

Licencja
MIT
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Przeszukuje bazy wiedzy w Markdown, notatki i dokumentację za pomocą QMD, aby znaleźć dokumenty i informacje.

Oryginalny opis (EN)

Search markdown knowledge bases, notes, and documentation using QMD. Use when users ask to search notes, find documents, or look up information.

Jak działa

  1. Status
  2. MCP: query
  3. Other MCP Tools
  4. CLI
  5. HTTP API
  6. Setup
Sekcje z nagłówków SKILL.md, w oryginale · 135 linii, 583 słów
Podgląd SKILL.md
---
name: qmd
description: Search markdown knowledge bases, notes, and documentation using QMD. Use when users ask to search notes, find documents, or look up information.
license: MIT
compatibility: Requires qmd CLI or MCP server. Install via `npm install -g @tobilu/qmd`.
metadata:
  author: tobi
  version: "2.0.0"
allowed-tools: Bash(qmd:*), mcp__qmd__*
---

# QMD - Quick Markdown Search

Local search engine for markdown content.

## Status

!`qmd status 2>/dev/null || echo "Not installed: npm install -g @tobilu/qmd"`

## MCP: `query`

```json
{
  "searches": [
    { "type": "lex", "query": "CAP theorem consistency" },
    { "type": "vec", "query": "tradeoff between consistency and availability" }
  ],
  "collections": ["docs"],
  "limit": 10
}
```

### Query Types

| Type | Method | Input |
|------|--------|-------|
| `lex` | BM25 | Keywords — exact terms, names, code |
| `vec` | Vector | Question — natural language |
| `hyde` | Vector | Answer — hypothetical result (50-100 words) |

### Writing Good Queries

**lex (keyword)**
- 2-5 terms, no filler words
- Exact phrase: `"connection pool"` (quoted)
- Exclude terms: `performance -sports` (minus prefix)
- Code identifiers work: `handleError async`

**vec (semantic)**
- Full natural language question
- Be specific: `"how does the rate limiter handle burst traffic"`
- Include context: `"in the payment service, how are refunds processed"`

**hyde (hypothetical document)**
- Write 50-100 words of what the *answer* looks like
- Use the vocabulary you expect in the result

**expand (auto-expand)**
- Use a single-line query (implicit) or `expand: question` on its own line
- Lets the local LLM generate lex/vec/hyde variations
- Do not mix `expand:` with other typed lines — it's either a standalone expand query or a full query document

### Intent (Disambiguation)

When a query term is ambiguous, add `intent` to steer results:

```json
{
  "searches": [
    { "type": "lex", "query": "performance" }
  ],
  "intent": "web page load times and Core Web Vitals"
}
```

Intent affects expansion, reranking, chunk selection, and snippet extraction. It does not search on its own — it's a steering signal that disambiguates queries like "performance" (web-perf vs team health vs fitness).

### Combining Types

| Goal | Approach |
|------|----------|
| Know exact terms | `lex` only |
| Don't know vocabulary | Use a single-line query (implicit `expand:`) or `vec` |
| Best recall | `lex` + `vec` |
| Complex topic | `lex` + `vec` + `hyde` |
| Ambiguous query | Add `intent` to any combination above |

First query gets 2x weight in fusion — put your best guess first.

### Lex Query Syntax

| Syntax | Meaning | Example |
|--------|---------|---------|
| `term` | Prefix match | `perf` matches "performance" |
| `"phrase"` | Exact phrase | `"rate limiter"` |
| `-term` | Exclude | `performance -sports` |

Note: `-term` only works in lex queries, not vec/hyde.

### Collection Filtering

```json
{ "collections": ["docs"] }              // Single
{ "collections": ["docs", "notes"] }     // Multiple (OR)
```

Omit to search all collections.

## Other MCP Tools

| Tool | Use |
|------|-----|
| `get` | Retrieve doc by path or `#docid` |
| `multi_get` | Retrieve multiple by glob/list |
| `status` | Collections and health |

## CLI

```bash
qmd query "question"              # Auto-expand + rerank
qmd query $'lex: X\nvec: Y'       # Structured
qmd query $'expand: question'     # Explicit expand
qmd query --json --explain "q"    # Show score traces (RRF + rerank blend)
qmd search "keywords"             # BM25 only (no LLM)
qmd get "#abc123"                 # By docid
qmd multi-get "journals/2026-*.md" -l 40  # Batch pull snippets by glob
qmd multi-get notes/foo.md,notes/bar.md   # Comma-separated list, preserves order
```

## HTTP API

```bash
curl -X POST http://localhost:8181/query \
  -H "Content-Type: application/json" \
  -d '{"searches": [{"type": "lex", "query": "test"}]}'
```

## Setup

```bash
npm install -g @tobilu/qmd
qmd collection add ~/notes --name notes
qmd embed
```
Pliki w paczce (2)
  • SKILL.md 4 KB
  • references/mcp-setup.md 2 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · ai-workspace-lab/xworkspace-core-skills100MIT
yassimba/loom100Apache-2.0
davidgasquez/dotfiles100MIT
SAP/e-mobility-charging-stations-simulator100Apache-2.0
tobi/qmd100MIT
ckorhonen/claude-skills100MIT
alsk1992/CloddsBot100MIT

Migawka bazy z 13.11.2026 · wersja paczki cc2281305e18 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100qmd-search
    Przeszukuje lokalny vault Obsidian lub bazę markdown według znaczenia silnikiem qmd na urządzeniu (BM25, wektory, rerank LLM), w pełni lokalnie.
  • 100add-qmd
    Dodaje QMD jako rozszerzony backend wyszukiwania w pamięci, zastępujący wyszukiwanie grep hybrydowym BM25 i wektorowym z rerankingiem LLM, w pełni lokalnie i bez kluczy API.
  • 95qmd-extended
    Zarządza rozszerzoną bazą wiedzy QMD z wieloma backendami embeddingów (Google AI Studio, Ollama, lokalny): przełączanie backendów, testy jakości, reindeksacja i rozwiązywanie problemów z wyszukiwaniem wektorowym.
  • 100brain
    Przeszukuje i analizuje zarządzane notatki, decyzje, runbooki i konwencje, zwracając cytat qmd:// dla każdego poparcia twierdzenia, o architekturze, infrastrukturze i praktykach operacyjnych.
  • 95index
    Indeksuje ADR, specyfikacje i kod repozytorium w kolekcjach qmd, by agenci mogli przeszukiwać je semantycznie.
  • 90using-kit-for-ai
    Zapisuje i przywołuje pamięć między sesjami, przeszukuje bazy wiedzy i zamienia dokumenty lub adresy URL na Markdown albo JSON.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.