Skills

This brain uses the gbrain skill pack at ~/gbrain/skills/. Skills are read-before-act: the agent reads the skill file, then performs the action.

Always-on

Every inbound message: read and follow:

• ~/gbrain/skills/RESOLVER.md - master skill dispatcher
• ~/gbrain/skills/signal-detector/SKILL.md - detect brain-relevant signals
• ~/gbrain/skills/brain-ops/SKILL.md - any brain read/write/lookup
• ~/gbrain/skills/conventions/quality.md - citations, back-links, notability

Filing new pages

Before creating any brain page: read ~/brain/RESOLVER.md (this brain’s filing tree) plus ~/gbrain/skills/_brain-filing-rules.md (how gbrain’s tooling expects filing to work).

Brain location

• Brain repo: ~/brain
• PGLite DB: ~/.gbrain/brain.pglite
• Keys: ~/.config/gbrain/keys.env (source before running gbrain commands)

Running gbrain

source ~/.config/gbrain/keys.env && gbrain <command>

Key commands

• gbrain doctor - health check
• gbrain stats - page + embedding coverage
• gbrain search "<query>" - hybrid search
• gbrain sync --repo ~/brain - pull repo changes into DB
• gbrain embed --stale - embed any unembedded chunks
• gbrain extract links --source db - backfill entity graph
• gbrain extract timeline --source db - backfill timeline