mcpField
S
second-brain-query

second-brain-query

github.com/nicholasspisakProductivity7642.5k installsUpdated 29w ago
Repository

About second-brain-query

A skill that searches and synthesizes a wiki to answer questions, for users working with an Obsidian-style linked knowledge base. It starts with the index, cites wiki pages, and can save useful synthesis with the user's approval.

Key features

  1. 01Finds relevant pages from the index
  2. 02Uses qmd for large wiki searches
  3. 03Follows links for related context
  4. 04Cites wiki pages in answers
  5. 05Can save synthesis as a page

Use cases

  1. 01Answering factual questions from ingested sources
  2. 02Comparing topics and saving an analysis

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/nicholasspisak/second-brain --skill second-brain-query

After installing, type/second-brain-queryin Claude Code to confirm it loaded.

Details

From the project README

Second Brain — Query

Answer questions by searching and synthesizing knowledge from the wiki.

Search Strategy

1. Start with the index

Read wiki/index.md to identify relevant pages. Scan all category sections (Sources, Entities, Concepts, Synthesis) for entries related to the question.

2. Use qmd for large wikis

If qmd is installed (check with command -v qmd), use it for search:

qmd search "query terms" --path wiki/

This is especially useful when the wiki has grown beyond ~100 pages where scanning the index becomes inefficient.

3. Read relevant pages

Read the wiki pages identified by the index or search. Follow [[wikilinks]] to pull in related context from linked pages. Read enough pages to give a thorough answer, but don't read the entire wiki.

4. Check raw sources if needed

If the wiki pages don't fully answer the question, check relevant source summaries in wiki/sources/ for additional detail. Only go to files in raw/ as a last resort.

Synthesize the Answer

Format

Match the answer format to the question:

  • Factual question → direct answer with citations
  • Comparison → table or structured comparison
  • Exploration → narrative with linked concepts
  • List/catalog → bulleted list with brief descriptions
Citations

Always cite wiki pages using [[wikilink]] syntax. Example:

According to [[Source - Article Title]], the key finding was X. This connects to the broader pattern described in [[Concept Name]], which [[Entity Name]] has also explored.

Offer to save valuable answers

If the answer produces something worth keeping — a comparison, analysis, new connection, or synthesis — offer to save it:

"This comparison might be useful to keep in your wiki. Want me to save it as a synthesis page?"

If the user agrees:

  1. Create a new page in wiki/synthesis/ with proper frontmatter
  2. Add an entry to wiki/index.md under Synthesis
  3. Append to wiki/log.md: ## [YYYY-MM-DD] query | Question summary

Conventions

  • Search the wiki first. Only go to raw sources if the wiki doesn't have the answer.
  • Cite your sources. Every factual claim should link to the wiki page it came from.
  • Valuable answers compound. Encourage saving good analyses back into the wiki.
  • Use [[wikilinks]] for all internal references. Never use raw file paths.

Related Skills

  • /second-brain-ingest — process new sources into wiki pages
  • /second-brain-lint — health-check the wiki for issues

Comments

Markdown supported