retrieval-reflex

Retrieves brain pages for salient entities before answering from memory.

Updated Aug 17, 2026
One-click install
npx skills add https://github.com/AMC-JTC/gbrain-1 --skill retrieval-reflex-amc-jtc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: retrieval-reflex
Source: https://github.com/AMC-JTC/gbrain-1/tree/main/recipes/retrieval-reflex/skills/retrieval-reflex
Command: npx skills add https://github.com/AMC-JTC/gbrain-1 --skill retrieval-reflex-amc-jtc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI agents often answer questions about people, companies, or projects from memory alone, missing facts already stored in the knowledge base. This Skill encodes a retrieval reflex: when an entity becomes salient in conversation, open its brain page before answering. ## Core Features & Use Cases - Trigger Policy: Defines when to retrieve — when an entity is the subject of a message, a brain-page pointer appears in context, an unrecognized notable name appears, or a non-trivial detail is about to be asserted. - Escalating Retrieval Spec: Pulls only what the task needs, from pointer metadata, to full pages via get_page, to graph neighbors via traverse_graph and get_backlinks. - Use Case: When a user asks "what do we know about Acme AI?", the agent opens the Acme AI brain page and checks its graph edges before responding, instead of guessing from context. ## Quick Start Ask the agent "who is Jane Doe?" and it will open her brain page and pull linked neighbors before answering.

Frequently Asked Questions about retrieval-reflex

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make an AI agent check a knowledge base before answering?

Encode a trigger policy that retrieves on demand when an entity becomes salient. Open the entity's page with get_page before asserting details, and pull graph neighbors only when relationship context is needed.

When should an agent retrieve a page versus answer from context?

Retrieve when an entity is the subject of the message, a brain-page pointer appeared this turn, an unrecognized notable name appears, or you are about to assert a non-trivial detail. Skip trivial passing mentions and anything already loaded in context.

What tools does retrieval-reflex use to query the brain?

It uses get_page to open full pages, query for search, and traverse_graph plus get_backlinks for relationship context. Over the CLI, traverse_graph and get_backlinks map to gbrain graph and gbrain backlinks.

Does retrieval-reflex write or modify knowledge base pages?

No, it is read-only. The frontmatter sets mutating to false and writes_pages to false, so it only retrieves pages, pointers, and graph neighbors without altering any stored content.

How much context should an agent load for one entity?

Escalate only as far as the task needs: stop at pointer metadata for identity checks, open the full page when details matter, and pull graph or backlinks only for relationship questions. Resolve only the names the current task needs, then drop them.