Skip to content

Migrate Notes into GBrain

Import notes from Obsidian, Notion, Logseq, CSV, JSON or Roam into the GBrain knowledge store

Repository
garrytan/gbrain
Stars
31,447
Licence
MIT
Files
1 file

What it does

When you ask the agent to move your notes or wiki into GBrain, this skill tells it how to do it safely: check the source format, test on a small sample of 5-10 files, then import the rest and verify the results by reading pages back. It also converts links such as Obsidian wikilinks and Logseq block references into GBrain links, and runs a health check afterward. The skill states that source files are never modified or deleted.

Great for

  • People moving an Obsidian vault, Notion export, or Logseq graph into GBrain
  • Teams connecting an existing company Git repository to a GBrain instance on a trusted host
  • Anyone with CSV or JSON contact or CRM exports they want as searchable pages

Skip it if

  • Users who do not run GBrain; the skill only targets GBrain tools like put_page, search and sync_brain, and will not help with other note apps directly
  • Importing into a personal brain that already has a global schema, since the skill warns against activating schemas to work around refusals and the import can change shared grants
  • Sensitive private data pasted without review, because imported content is treated as data and the skill still writes it into a knowledge store that may be indexed or embedded

Try asking

  • “Migrate from Obsidian: import my vault into GBrain and convert my wikilinks”
  • “Import from Notion using my exported Markdown & CSV folder”
  • “Connect our company brain using our committed Git repository”
  • “Import this contacts CSV into GBrain, using name as the slug and notes as the body”
Step-by-step guide: how to use Migrate Notes into GBrainInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    migrate.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip migrate.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip migrate.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Let the agent run the sample import first and check the results before approving a bulk import
  • Keep your source folder committed in Git with no uncommitted changes so the inspection step can run cleanly
  • Expect missing embeddings after import; search runs keyword-only until embeddings are backfilled separately

What's inside

  • SKILL.md

Redistributed unmodified from garrytan/gbrain under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.