second-brain-query
GitHub用于通过检索和综合知识库wiki来回答用户问题。支持从索引或qmd工具搜索，读取相关页面及原始来源，按问题类型生成带引用的答案，并可提议将高质量分析保存为新的合成页面以丰富知识库。
Trigger Scenarios
Install
npx skills add NicholasSpisak/second-brain --skill second-brain-query -g -y
SKILL.md
Frontmatter
{
"name": "second-brain-query",
"description": "Answer questions against the knowledge base wiki. Use when the user asks a question about their collected knowledge, wants to explore connections between topics, says \"what do I know about X\", or wants to search their wiki.\n",
"allowed-tools": "Bash Read Write Edit Glob Grep"
}
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:
- Create a new page in
wiki/synthesis/with proper frontmatter - Add an entry to
wiki/index.mdunder Synthesis - 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
Version History
- 3e429c7 Current 2026-07-05 10:39
