Skip to content
OpenSmartRoute
Skillv1.0.0

gbrain-lite

Lightweight personal knowledge base — markdown + YAML frontmatter structured notes with full-text search and cross-referencing for AI agents

by gabrielmoreira(0) 0 installs
Free
Sign in to install

Free account. Installing gives you the manifest plus copy-paste snippets.

See reviews

About

Imported from gabrielmoreira/agent-skills-mirror (mirrors/repos/cosmicstack-labs@mercury-agent-skills/categories/ai-ml/gbrain-lite/SKILL.md). Install upstream with npx skills add gabrielmoreira/agent-skills-mirror --skill gbrain-lite. Copyright stays with the author.

GBrain Lite — Lightweight Personal Knowledge Base

Organize books, people, concepts, and news items from conversations into a searchable, cross-referenced markdown knowledge base.

Workspace

  • Knowledge base directory: brain/
  • Subdirectories by type: books/ people/ meetings/ ideas/ articles/ projects/ news/
  • One entry = one .md file
  • News entries by date: news/YYYY-MM-DD/

Workflow

  1. Trigger check — Book/person/concept/news mentioned in conversation → proactively check brain
  2. Search — Full-text search in brain/ directory (ripgrep/grep)
  3. Decide
    • Existing entry → reference it, update if needed
    • No entry + important → create immediately
    • No entry + uncertain → ask user
  4. Create — Write brain/{type}/{slug}.md
    • Slug: lowercase/hyphenated
    • Must include YAML frontmatter (title, type, date, tags, summary)
  5. Cross-reference — Update links field in related entries
  6. Sync — Keep key entry index in agent memory

Rules

  • Don't dump long content directly into agent memory — prefer brain
  • Don't create entries without title and date
  • Don't skip the summary field — search and listing depend on it
  • Don't manually write updated — it auto-updates on save
  • News entries must use item_id as dedup key (format: github:owner/repo / hn:12345 / arxiv:url)
  • Don't do full overwrite updates on existing entries — use targeted patches

Validation

  • New entry has complete frontmatter (title, type, date, tags, summary)
  • Full-text search finds the new entry
  • News entries contain item_id + first_seen + star_history (GitHub entries)
  • Agent memory usage below 90%, otherwise trigger distillation to brain

Pitfalls

Brain vs Memory confusion

  • Symptom: Long-form content consumed all agent memory space
  • Root cause: Everything dumped into memory instead of brain
  • Fix: >500 chars → brain entry; memory only keeps index pointers. (Fixed: 2026-05-12)

Missing item_id on news entries

  • Symptom: Duplicate news entries accumulate, dedup impossible
  • Root cause: Agent skipped item_id field when creating news entries
  • Fix: Always include item_id for news entries, validated in creation workflow

References

  • references/garry-tan-gbrain-inspiration.md — GBrain system design reference

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml
targets:
  - https://api.opensmartroute.ai/api/v1/registry/gabrielmoreira-agent-skills-mirror-gbrain-lite/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

gabrielmoreira-agent-skills-mirror-gbrain-lite.ocm.jsonjson
{
  "ocm": "1",
  "id": "gabrielmoreira-agent-skills-mirror-gbrain-lite",
  "kind": "skill",
  "name": "gbrain-lite",
  "description": "Lightweight personal knowledge base — markdown + YAML frontmatter structured notes with full-text search and cross-referencing for AI agents",
  "publisher": "gabrielmoreira",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "knowledge-base",
      "memory-management",
      "markdown",
      "cross-referencing",
      "agent-memory",
      "personal-knowledge-graph",
      "github"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Lightweight personal knowledge base — markdown + YAML frontmatter structured notes with full-text search and cross-referencing for AI agents"
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github",
      "repository": "https://github.com/gabrielmoreira/agent-skills-mirror",
      "path": "mirrors/repos/cosmicstack-labs@mercury-agent-skills/categories/ai-ml/gbrain-lite/SKILL.md",
      "ref": "d5c793801e2fc9c29aa3531805809b3460b19d09",
      "url": "https://github.com/gabrielmoreira/agent-skills-mirror/blob/d5c793801e2fc9c29aa3531805809b3460b19d09/mirrors/repos/cosmicstack-labs@mercury-agent-skills/categories/ai-ml/gbrain-lite/SKILL.md",
      "key": "gabrielmoreira/agent-skills-mirror/mirrors/repos/cosmicstack-labs@mercury-agent-skills/categories/ai-ml/gbrain-lite/SKILL.md"
    }
  },
  "instructions": "# GBrain Lite — Lightweight Personal Knowledge Base\n\n> Organize books, people, concepts, and news items from conversations into a searchable, cross-referenced markdown knowledge base.\n\n## Workspace\n\n- Knowledge base directory: `brain/`\n- Subdirectories by type: `books/` `people/` `meetings/` `ideas/` `articles/` `projects/` `news/`\n- One entry = one `.md` file\n- News entries by date: `news/YYYY-MM-DD/`\n\n## Workflow\n\n1. **Trigger check** — Book/person/concept/news mentioned in conversation → proactively check brain\n2. **Search** — Full-text search in `brain/` directory (ripgrep/grep)\n3. **Decid",
  "cost": {
    "context_tokens": 584
  }
}

Fetch it by URL: GET /api/v1/registry/gabrielmoreira-agent-skills-mirror-gbrain-lite/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.