benoror/obsidianos_work / .agents/skills/qmd
qmd
VerifiedSearch vault notes by keyword or meaning. Args: <query>. Uses QMD (lex, vec, deep search).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.4 KB |
| references/mcp-setup.md | markdown | 1.9 KB |
references/mcp-setup.md
View on GitHub# QMD MCP Server Setup
## Install
```bash
npm install -g @tobilu/qmd
qmd collection add ~/path/to/markdown --name myknowledge
qmd embed
```
## Configure MCP Client
**Claude Code** (`~/.claude/settings.json`):
```json
{
"mcpServers": {
"qmd": { "command": "qmd", "args": ["mcp"] }
}
}
```
**Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
```json
{
"mcpServers": {
"qmd": { "command": "qmd", "args": ["mcp"] }
}
}
```
**OpenClaw** (`~/.openclaw/openclaw.json`):
```json
{
"mcp": {
"servers": {
"qmd": { "command": "qmd", "args": ["mcp"] }
}
}
}
```
## HTTP Mode
```bash
qmd mcp --http # Port 8181
qmd mcp --http --daemon # Background
qmd mcp stop # Stop daemon
```
## Tools
### structured_search
Search with pre-expanded queries.
```json
{
"searches": [
{ "type": "lex", "query": "keyword phrases" },
{ "type": "vec", "query": "natural language question" },
{ "type": "hyde", "query": "hypothetical answer passage..." }
],
"limit": 10,
"collection": "optional",
"minScore": 0.0
}
```
| Type | Method | Input |
|------|--------|-------|
| `lex` | BM25 | Keywords (2-5 terms) |
| `vec` | Vector | Question |
| `hyde` | Vector | Answer passage (50-100 words) |
### get
Retrieve document by path or `#docid`.
| Param | Type | Description |
|-------|------|-------------|
| `path` | string | File path or `#docid` |
| `full` | bool? | Return full content |
| `lineNumbers` | bool? | Add line numbers |
### multi_get
Retrieve multiple documents.
| Param | Type | Description |
|-------|------|-------------|
| `pattern` | string | Glob or comma-separated list |
| `maxBytes` | number? | Skip large files (default 10KB) |
### status
Index health and collections. No params.
## Troubleshooting
- **Not starting**: `which qmd`, `qmd mcp` manually
- **No results**: `qmd collection list`, `qmd embed`
- **Slow first search**: Normal, models loading (~3GB)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |