wiki-import

Import wiki knowledge graphs into an Obsidian vault from graph.json exports or OKF markdown bundles.

Updated Nov 9, 2023
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill wiki-import-oresttokovenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wiki-import
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/wiki-import
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill wiki-import-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Transferring pages between Obsidian vaults or restoring a knowledge base from an export requires manually recreating frontmatter, wikilinks, and relationships. This Skill reconstructs pages automatically from a wiki-export graph.json file (as stubs) or an OKF markdown bundle (as full pages), then updates all vault metadata. ## Core Features & Use Cases - Dual-source import: Reconstruct page stubs from a graph.json skeleton or restore full page bodies from an OKF (Open Knowledge Format) bundle for lossless vault-to-vault transfer. - Conflict resolution modes: Choose merge (default, idempotent), skip existing pages, or overwrite to control how existing vault content is handled. - Vault metadata updates: Automatically updates .manifest.json, index.md, log.md, and hot.md with import statistics and page entries. - Use Case: You exported a research vault with wiki-export and want to load it into a new vault. Point the Skill at the OKF bundle directory and it recreates every page with original frontmatter, bodies, and wikilinks intact. ## Quick Start Import the wiki-export OKF bundle in the current directory into my Obsidian vault using merge mode.

Frequently Asked Questions about wiki-import

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

FAQPage Schema
How do I import a wiki export into an Obsidian vault?

Point the Skill at either a graph.json file or an OKF bundle directory produced by wiki-export. It auto-detects the source type, shows a preview, then reconstructs pages with correct frontmatter and wikilinks into your vault.

What is the difference between graph.json and OKF bundle import?

A graph.json import creates stubs with frontmatter, typed relationships, and a Related link list but no body content. An OKF bundle import restores full pages with their original markdown bodies, making it the lossless option for vault-to-vault transfer.

Will importing overwrite my existing Obsidian pages?

By default the merge mode updates existing pages non-destructively, unioning tags and relationships while leaving bodies intact. Use skip mode to leave existing pages untouched, or overwrite mode to fully replace them with imported content.

Is re-running a wiki import safe or idempotent?

Yes, the default merge mode is idempotent. Re-running on an unchanged export only refreshes timestamps and will not destroy existing content, so repeated imports are safe.

What happens to markdown links during an OKF bundle import?

Markdown links pointing at .md paths are resolved to concept ids and converted back into wikilinks, including links to pages not present in the bundle. External http links and Citations sections are left untouched.