obsidian-to-expertpack

name	obsidian-to-expertpack
description	Convert an existing Obsidian Vault into an agent-ready ExpertPack. Restructures vault content for EK optimization, RAG retrieval, and OpenClaw integration. Creates a copy — source vault is never modified. Use when: a user wants to make their Obsidian Vault usable by AI agents, convert OV to EP, drop their vault into OpenClaw as a knowledge pack, or make their notes RAG-ready. Triggers on: 'obsidian to expertpack', 'obsidian vault to ep', 'convert obsidian', 'OV to EP', 'obsidian agent ready', 'make my vault ai ready', 'obsidian knowledge pack', 'obsidian rag'.
metadata	{"openclaw":{"homepage":"https://expertpack.ai","requires":{"bins":["python3"],"pip":["pyyaml"]}}}

Obsidian Vault → ExpertPack

Converts an Obsidian Vault into a structured ExpertPack — agent-ready, RAG-optimized, and OpenClaw-compatible. Source vault is never modified; output is a clean copy.

Learn more: expertpack.ai · GitHub

Companion skills: Install expertpack for full EP workflows. Install expertpack-eval to measure EK ratio after conversion.

Step 1: Analyze the Vault

Before running the script, inspect the vault:

1. List the top-level directories — these map to EP content sections
2. Identify the pack type based on structure:
   • journals/, daily/, people/, mind/ → person
   • concepts/, workflows/, troubleshooting/, faq/ → product
   • phases/, checklists/, decisions/, steps/ → process
   • Mix of the above → composite
3. Note any templates/ or _templates/ folders — exclude from conversion
4. Estimate content volume and identify the highest-EK directories

The script auto-detects type (--type auto) but verify your judgment matches before proceeding. See references/migration-guide.md for the full decision tree.

Step 2: Run the Conversion Script

python3 /path/to/ExpertPack/skills/obsidian-to-expertpack/scripts/convert.py \
  /path/to/obsidian-vault \
  --output ~/expertpacks/my-pack-slug \
  --name "My Pack Name" \
  [--type auto|person|product|process|composite] \
  [--dry-run]

Always do a --dry-run first to preview what will be converted.

What the script produces:

• All .md files copied with EP frontmatter (title, type, tags, pack, created)
• Inline #hashtags extracted into frontmatter tags:
• Dataview query blocks stripped (computed views, not knowledge)
• [text](file.md) links converted to [[wikilinks]]
• manifest.yaml, overview.md, glossary.md at pack root
• _index.md in each content directory
• .obsidian/ config copied (pack opens in Obsidian immediately)

For detailed handling of Obsidian-specific patterns (nested tags, daily notes, templates, attachments): read references/migration-guide.md.

Step 3: Validate & Fix

# Fix common issues first (links includes broken-wikilink cleanup of cross-vault references)
python3 /path/to/ExpertPack/tools/validator/ep-doctor.py ~/expertpacks/my-pack-slug --apply

# Must reach 0 errors
python3 /path/to/ExpertPack/tools/validator/ep-validate.py ~/expertpacks/my-pack-slug --verbose

Do not proceed until ep-validate reports 0 errors.

Step 4: Agent-Assisted Enhancement

After validation, enhance retrieval quality:

1. Opening definitions — make the first paragraph of each concept a 1–3 sentence retriever-anchored definition.
2. Related terms — embed relative/domain terms inside the owning concept under ## Related Terms; avoid glossary hubs unless truly cross-cutting and navigational.
3. Atomic-conceptual structure (v4.1) — structure each concept file as a self-contained retrieval unit: frontmatter with requires: / related:, retriever-anchored opening paragraph, body sections, and optional ## Frequently Asked, ## Related Terms, and ## Related Concepts. Do NOT create separate propositions/ or summaries/ directories.
4. EK triage — identify low-EK files (general knowledge) and compress or remove them
5. File size — split concept files >1,000 tokens into independent atoms with requires: dependencies where needed

Step 5: Configure RAG in OpenClaw

Add to ~/.openclaw/openclaw.json:

{
  "agents": {
    "defaults": {
      "memorySearch": {
        "extraPaths": ["/path/to/your/converted-pack"]
      }
    }
  }
}

Restart OpenClaw after config change. The pack is now searchable in every session.

Step 6: Measure EK Ratio

clawhub install expertpack-eval

Run evals to score how much esoteric knowledge the pack contains vs. what the model already knows. Target EK ratio >0.6 for high-value packs.