Skip to content

Fastest way to scaffold your LLM powered personal knowledge base - Obsidian, Claude Code, qmd, Github

feat: remove qmd-cli skill

jessepinkman9900c975eadecd46
diff --git a/.claude/skills/pack-test/SKILL.md b/.claude/skills/pack-test/SKILL.md
index b37b494..0d7734b 100644
--- a/.claude/skills/pack-test/SKILL.md
+++ b/.claude/skills/pack-test/SKILL.md
@@ -159,7 +159,7 @@ RESOLVED_B=$(npx -y claude-second-brain-$(node -p "require('./package.json').ver
| `.gitignore` (not `.gitignore.template`) | Present in both brains | |
| `wiki/{index,log,overview}.md`, `sources/`, `qa/` | Present in both brains | |
| `raw-sources/{articles,pdfs,personal}/` | Present in both brains | |
-| `.claude/skills/` — 7 subdirs | brain-ingest, brain-search, brain-refresh, brain-rebuild, lint, qmd-cli, setup | |
+| `.claude/skills/` — 6 subdirs | brain-ingest, brain-search, brain-refresh, brain-rebuild, lint, setup | |
| `scripts/qmd/{setup,reindex}.ts` | Present in both brains, DB hardcoded to `.qmd/index.sqlite` relative | |
| `CLAUDE.md`, `mise.toml`, `package.json` | Present in both brains | |
| `CLAUDE.md` INDEX_PATH | Relative `INDEX_PATH=.qmd/index.sqlite` (no absolute substitution) | |
diff --git a/.github/workflows/pack-test.yml b/.github/workflows/pack-test.yml
index 369b52e..040df45 100644
--- a/.github/workflows/pack-test.yml
+++ b/.github/workflows/pack-test.yml
@@ -62,7 +62,6 @@ jobs:
check ".claude/skills/brain-refresh" "$VAULT/.claude/skills/brain-refresh"
check ".claude/skills/brain-rebuild" "$VAULT/.claude/skills/brain-rebuild"
check ".claude/skills/lint" "$VAULT/.claude/skills/lint"
- check ".claude/skills/qmd-cli" "$VAULT/.claude/skills/qmd-cli"
check "scripts/qmd/setup.ts" "$VAULT/scripts/qmd/setup.ts"
check "scripts/qmd/reindex.ts" "$VAULT/scripts/qmd/reindex.ts"
check "package.json" "$VAULT/package.json"
diff --git a/CLAUDE.md b/CLAUDE.md
index acd2d13..2f87a42 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -240,7 +240,7 @@ Whenever you **add, remove, or rename a skill** under `template/.claude/skills/`
1. **`README.md`** (root) — the "Claude Code skills included" section and the "Installing and updating skills" block. Bump the skill count ("N wiki skills") in the install commands.
2. **`template/README.md`** — the "Your Claude Code skills" section and the "Installing and updating skills" block. Bump the skill count.
-3. **`bin/create.js`** — the `GLOBAL_SKILLS` array (top of the file) if the skill should be installed globally (`~/.claude/skills/`). `brain-ingest`, `brain-search`, `brain-refresh` are global today; `brain-rebuild`, `lint`, `setup`, `qmd-cli` are vault-local.
+3. **`bin/create.js`** — the `GLOBAL_SKILLS` array (top of the file) if the skill should be installed globally (`~/.claude/skills/`). `brain-ingest`, `brain-search`, `brain-refresh` are global today; `brain-rebuild`, `lint`, `setup` are vault-local.
4. **`.github/workflows/pack-test.yml`** — add a `check` line for the new vault-local skill directory, and if the skill is global, add `check` lines for `$HOME/.claude/skills/<name>/SKILL.md` and `$HOME/.claude/skills/<name>/.csb-version`, plus `grep_check` lines for `claude-second-brain path` and `claude-second-brain qmd` (global skills use the CLI proxy, not a baked INDEX_PATH).
5. **`.claude/skills/pack-test/SKILL.md`** — update the expected-skills comment, the `ls` and `grep` commands in Step 3, the checklist table (including the "N subdirs" count), and the cleanup / overwrite-warning note in Step 4.
diff --git a/README.md b/README.md
index 38851df..b4f07e9 100644
--- a/README.md
+++ b/README.md
@@ -268,14 +268,14 @@ npx claude-second-brain qmd -- query -c wiki "<terms>" # run qmd against the d
## Installing and updating skills
-Skills are slash commands Claude Code loads from `.claude/skills/[name]/SKILL.md`. `/brain-ingest`, `/brain-search`, and `/brain-refresh` install globally to `~/.claude/skills/` during setup so they work in any Claude Code session. `/brain-rebuild`, `/lint`, `/setup`, and `/qmd-cli` live inside the vault at `.claude/skills/`.
+Skills are slash commands Claude Code loads from `.claude/skills/[name]/SKILL.md`. `/brain-ingest`, `/brain-search`, and `/brain-refresh` install globally to `~/.claude/skills/` during setup so they work in any Claude Code session. `/brain-rebuild`, `/lint`, and `/setup` live inside the vault at `.claude/skills/`.
### Update the built-in wiki skills
The wiki's own skills are scaffolded at creation time. To pull in improvements, use `npx skills` pointing to the template skills directory in this repo:
```bash
-# Install or update all 7 wiki skills from the latest template
+# Install or update all 6 wiki skills from the latest template
npx skills add https://github.com/jessepinkman9900/claude-second-brain/tree/main/template/.claude/skills -a claude-code -y
# Or update a specific skill
diff --git a/docs/pages/skills.mdx b/docs/pages/skills.mdx
index 942302b..c998610 100644
--- a/docs/pages/skills.mdx
+++ b/docs/pages/skills.mdx
@@ -19,12 +19,12 @@ The wiki ships with a set of Claude Code slash commands that cover the full work
## Install or update skills
-`/brain-ingest`, `/brain-search`, and `/brain-refresh` install globally to `~/.claude/skills/` during setup so they work in any Claude Code session. `/brain-rebuild`, `/lint`, `/setup`, and `/qmd-cli` live inside the vault at `.claude/skills/`.
+`/brain-ingest`, `/brain-search`, and `/brain-refresh` install globally to `~/.claude/skills/` during setup so they work in any Claude Code session. `/brain-rebuild`, `/lint`, and `/setup` live inside the vault at `.claude/skills/`.
To pull in improvements from the latest template:
```bash
-# Install or update all 7 wiki skills
+# Install or update all 6 wiki skills
npx skills add https://github.com/jessepinkman9900/claude-second-brain/tree/main/template/.claude/skills -a claude-code -y
# Or update a specific skill
diff --git a/template/.claude/skills/brain-rebuild/SKILL.md b/template/.claude/skills/brain-rebuild/SKILL.md
index 91904bc..e52e636 100644
--- a/template/.claude/skills/brain-rebuild/SKILL.md
+++ b/template/.claude/skills/brain-rebuild/SKILL.md
@@ -66,7 +66,7 @@ Edit `scripts/qmd/setup.ts` to reflect the new schema:
If collection names changed:
- Update every occurrence in `CLAUDE.md` (e.g. `qmd query -c wiki` → new name)
-- Update `.claude/skills/brain-ingest/SKILL.md`, `.claude/skills/brain-search/SKILL.md`, `.claude/skills/lint/SKILL.md`, `.claude/skills/qmd-cli/SKILL.md` — anywhere collection names are hard-coded
+- Update `.claude/skills/brain-ingest/SKILL.md`, `.claude/skills/brain-search/SKILL.md`, `.claude/skills/lint/SKILL.md` — anywhere collection names are hard-coded
- Use Grep to find any remaining stale references before moving on
### Step 7 — Tear down the old schema
diff --git a/template/.claude/skills/qmd-cli/SKILL.md b/template/.claude/skills/qmd-cli/SKILL.md
deleted file mode 100644
index 2ed7409..0000000
--- a/template/.claude/skills/qmd-cli/SKILL.md
+++ /dev/null
@@ -1,168 +0,0 @@
----
-name: qmd-cli
-description: 'Use qmd CLI to manage collections, index documents, search, and query a local semantic knowledge base. Use when the user mentions qmd, searching a collection, indexing files, running queries, hybrid search, BM25, vector search, or managing a document index. Covers: collection add/list/remove/rename, context management, get/multi-get, update, embed, query, search, vsearch, and MCP server commands.'
-argument-hint: 'qmd command to run or describe what you want to do (e.g., "query wiki for X", "add folder to collection")'
----
-
-# qmd CLI
-
-Local semantic document index with hybrid search (BM25 + vector), collection management, and MCP server.
-
-## Vault DB
-
-This vault keeps its index at `.qmd/index.sqlite` (relative to the vault root). All CLI commands below run from the vault root and **must** prefix with `INDEX_PATH=.qmd/index.sqlite`:
-
-```bash
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd query -c wiki "..."
-```
-
-The scripts `pnpm qmd:setup` and `pnpm qmd:reindex` write to this same file. The CLI must match.
-
----
-
-## Collection Management
-
-```bash
-# Create/index a collection
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd collection add <path> --name <name> --mask <glob-pattern>
-# e.g.:
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd collection add wiki --name wiki --mask "**/*.md"
-
-# List all collections with details
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd collection list
-
-# Remove a collection
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd collection remove <name>
-
-# Rename a collection
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd collection rename <old-name> <new-name>
-```
-
-## Listing Files
-
-```bash
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd ls
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd ls [collection[/path]]
-```
-
-## Context
-
-```bash
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd context add [path] "description text"
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd context list
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd context rm <path>
-```
-
-## Retrieving Documents
-
-```bash
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd get <file>[:line] [-l N] [--from N]
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd multi-get <pattern> [-l N] [--max-bytes N]
-```
-
-**Multi-get format flags:** `--json`, `--csv`, `--md`, `--xml`, `--files`
-
-## Indexing & Maintenance
-
-```bash
-# Show index status and collections
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd status
-
-# Re-index all collections
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd update [--pull]
-
-# Create vector embeddings (900 tokens/chunk, 15% overlap)
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd embed [-f]
-
-# Remove cache and orphaned data, vacuum DB
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd cleanup
-```
-
-> After bulk ingest sessions, run `update` then `embed` to keep the index fresh.
-
-## Search & Query
-
-| Command | Description |
-|---------|-------------|
-| `qmd query <query>` | **Recommended** — hybrid search with query expansion + reranking |
-| `qmd search <query>` | Full-text keyword search (BM25, no LLM) |
-| `qmd vsearch <query>` | Pure vector/semantic similarity search |
-
-### Search Options
-
-```
--n <num> Number of results (default: 5, or 20 for --files)
---all Return all matches (use with --min-score to filter)
---min-score <num> Minimum similarity score
---full Output full document instead of snippet
---line-numbers Add line numbers to output
---files Output docid,score,filepath,context
---json JSON output with snippets
---csv CSV output
---md Markdown output
---xml XML output
--c, --collection <name> Filter results to a specific collection
-```
-
-### Examples
-
-```bash
-# Hybrid search across all collections
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd query "distributed systems consensus"
-
-# Search only the wiki collection, JSON output
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd query -c wiki "transformer architecture" --json
-
-# Keyword-only search, top 10, markdown output
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd search -c wiki "kafka" -n 10 --md
-
-# Vector search with full documents
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd vsearch "attention mechanism" --full
-
-# Filter by score threshold
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd query "machine learning" --all --min-score 0.7
-```
-
-## MCP Server
-
-```bash
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd mcp
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd mcp --http [--port N]
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd mcp --http --daemon
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd mcp stop
-```
-
-## Global Options
-
-```
---index <name> Use a custom index name (default: index)
-```
-
-Note: use `INDEX_PATH` env var rather than `--index` — `INDEX_PATH` accepts a file path while `--index` only accepts a short name mapped to `~/.cache/qmd/`.
-
-## Typical Workflows
-
-### First-time setup for this vault
-```bash
-# Handled by the /setup skill:
-pnpm qmd:setup
-pnpm qmd:reindex
-```
-
-### After a bulk ingest session
-```bash
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd update
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd embed
-```
-
-### Research workflow
-```bash
-# Discover relevant pages
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd query -c wiki "<topic>"
-
-# Get a specific file
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd get wiki/distributed-systems.md
-
-# Get multiple related files
-INDEX_PATH=.qmd/index.sqlite pnpm dlx @tobilu/qmd multi-get "wiki/kafka.md,wiki/distributed-systems.md" --md
-```
diff --git a/template/README.md b/template/README.md
index c520d7d..875b1a1 100644
--- a/template/README.md
+++ b/template/README.md
@@ -158,14 +158,14 @@ claude-second-brain/
## Installing and updating skills
-Skills are slash commands Claude Code loads from `.claude/skills/[name]/SKILL.md` in this vault. The wiki ships with `/brain-ingest`, `/brain-search`, `/brain-refresh`, `/brain-rebuild`, `/lint`, `/setup`, and `/qmd-cli` pre-installed.
+Skills are slash commands Claude Code loads from `.claude/skills/[name]/SKILL.md` in this vault. The wiki ships with `/brain-ingest`, `/brain-search`, `/brain-refresh`, `/brain-rebuild`, `/lint`, and `/setup` pre-installed.
### Update built-in wiki skills
Pull the latest skills from the upstream template:
```bash
-# Install or update all 7 wiki skills
+# Install or update all 6 wiki skills
npx skills add https://github.com/jessepinkman9900/claude-second-brain/tree/main/template/.claude/skills -a claude-code -y
# Or update a specific skill