Skills for Real Engineers. Straight from my .agents directory.
second-brain-query
Agent skill fromundefined-ui/second-brain-os
Answer a question from a second-brain vault by reading its own pages, citing the pages used, and saying plainly when the vault does not contain the answer. Use this skill whenever the user asks what they know about a topic, what they have read on something, what connects two ideas, what they have changed their mind about, or asks any question that should be answered from their own notes rather than general knowledge. Do NOT use for ingesting new material, for general questions the vault has nothing to do with, or when the user explicitly wants an answer from the open web.
How to install second-brain-query
npx skills add undefined-ui/second-brain-os# or add only this skill to Claude Code: copy the folder
skills/second-brain-query/
# into
~/.claude/skills/second-brain-query/ (all projects)
.claude/skills/second-brain-query/ (one project)
1# Query the vault23A query that quietly falls back on general knowledge is the most damaging thing4this system can do. The owner built the vault so answers would be grounded in5what they actually read, and an answer that blends the model's priors with6their notes is worse than no answer, because it cannot be checked.78## Core rule910Every claim in the answer comes from a page in the vault and names that page.11Anything you know but the vault does not is labelled as outside knowledge or12left out.1314## Workflow15161. **Start from `index.md`**, not from a full-text sweep. The index is the map;17 reading it first keeps the context budget for actual pages.182. **Follow links outward** from the most relevant pages, one hop at a time.19 Stop when new pages stop adding anything.203. **Answer in plain language**, with `[[page]]` references inline.214. **Name the gaps.** If the question has three parts and the vault covers two,22 say which one it does not.235. **Offer the next move** when there is an obvious one: a source worth24 ingesting, a synthesis page worth writing.2526## Output format2728Plain prose, then:2930```31Read: <pages consulted>32Not covered: <what the vault does not answer>33```3435## Calibration3637Reading too little is the common failure: answering from three pages when the38vault has fifteen relevant ones. Reading everything is the opposite failure and39burns the budget on pages that add nothing.4041If the vault has nothing on the topic, say so in one sentence and stop. Do not42…
Excerpt shown under the repository's MIT license.
More skills in second-brain-os
Similar skill repositories
An agentic skills framework & software development methodology that works.
Public repository for Agent Skills
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Production-grade engineering skills for AI coding agents.
