# Query

Answer questions using the brain's knowledge with 3-layer search, synthesis, and...

- Repository: https://github.com/garrytan/gbrain (31427 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add garrytan/gbrain --skill query -g -a claude-code -y`
Codex: `npx skills add garrytan/gbrain --skill query -g -a codex -y`
Cursor: `npx skills add garrytan/gbrain --skill query -g -a cursor -y`
Gemini CLI: `npx skills add garrytan/gbrain --skill query -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add garrytan/gbrain`

## Description

Answer questions using the brain's knowledge with 3-layer search, synthesis, and citation propagation. Use when the user asks a question, wants a lookup, or needs information from the brain.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Query Skill

Answer questions using the brain's knowledge with 3-layer search and synthesis.

> **Memory verbs (MEMORY_VERBS v1, gbrain ≥ 0.43).** When connected to a brain
> over MCP, prefer the seven frozen memory verbs for memory work, they carry
> provenance, evidence, and a server-enforced token budget:
> - **`recall(query | entity, budget_tokens)`**, the budget-packed memory read.
>   Use it instead of bare `search` for "what do we know that we SAVED about X".
> - **`entity(name)`**, a zero-LLM person/company/project card (aliases,
>   last-touched, open threads, top edges). Use it instead of `get_page` +
>   `get_backlinks` when you just need the card.
> - **`synthesize(question)`**, the explicitly-expensive cross-page answer; the
>   heavy version of `query`. Reach for it only when the answer must combine
>   evidence across pages.
> Fall back to `search`/`query`/`get_page` when the verbs aren't on the surface
> (pre-0.43 servers; `--surface full` includes the verbs alongside every other
> op). See `docs/protocol/MEMORY_VERBS_v1.md`.

## Contract

This skill guarantees:
- Every answer is grounded in brain content (no hallucination)
- Every claim has a citation tracing back to a specific page slug
- Gaps are flagged explicitly ("the brain doesn't have information on X")
- Source precedence is respected (user statements > compiled truth > timeline > external)
- Conflicting sources are noted with both citations

## Phases

The rest: https://github.com/garrytan/gbrain/blob/HEAD/plugin-variants/gbrain-coding/skills/query/SKILL.md