migrate

Migrate data from Obsidian, Notion, Logseq, Markdown, CSV, JSON, and Roam into GBrain.

1|Updated May 12, 2026
One-click install
npx skills add https://github.com/ltdrew/Agent-brain-2 --skill migrate-ltdrew
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate
Source: https://github.com/ltdrew/Agent-brain-2/tree/main/skills/migrate
Command: npx skills add https://github.com/ltdrew/Agent-brain-2 --skill migrate-ltdrew

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Universal migration from Obsidian, Notion, Logseq, plain Markdown directories, CSV, JSON, Roam, and other wiki or note tools into GBrain in an additive, non-destructive manner.

Core Features & Use Cases

  • Cross-source migration: import content from Obsidian, Notion, Logseq, Markdown directories, CSV and JSON exports, and Roam JSON into GBrain while preserving structure and cross-references.
  • Safe, additive workflow: source data is never modified or deleted; pages are verified after write-back to ensure integrity.
  • Verification & mapping: Wikilinks, block refs, and tags are converted to GBrain equivalents with health checks and sample validation.

Quick Start

Plan the migration by selecting your source directory and running migrate to import data into GBrain.

Frequently Asked Questions about migrate

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

FAQPage Schema
How do I migrate content from Notion and Obsidian into a wiki without losing cross-references?

To migrate content from Notion and Obsidian, this tool converts wikilinks, block refs, and tags into GBrain equivalents. It preserves structural integrity by mapping cross-references during the additive import workflow.

Can I import Markdown directories and JSON exports into GBrain safely?

Yes, you can import Markdown directories and JSON exports safely. The migration is additive and non-destructive, ensuring your source data is never modified or deleted during the transfer process.

What is the best way to verify page counts and link integrity after a wiki migration?

The best way to verify page counts and link integrity is using the built-in post-migration health-check report. It enforces verification of page counts, link integrity, and embeddings to ensure a successful data transfer.

Does migrating a large team wiki require a phased approach?

Yes, migrating a large team wiki supports a phased approach. The tool handles source assessment, mapping, and phase-based migration, allowing you to validate samples before completing large-scale data imports.

Why does my Roam JSON migration show broken block references?

Broken block references during a Roam JSON migration occur when conversion fails. This tool explicitly converts Roam block references into GBrain equivalents and runs link integrity checks to prevent and resolve such issues.