AgentSkillsCN

dex-obsidian-setup

启用 Obsidian 集成，将现有资料库迁移至 Wiki 链接。

SKILL.md
--- frontmatter
name: dex-obsidian-setup
description: Enable Obsidian integration and migrate existing vault to wiki links

Purpose

Convert Dex vault to Obsidian wiki link format for graph-based navigation.

Step 1: Check Current State

Read System/user-profile.yaml and check obsidian_mode field.

If already enabled:

  • •Say: "Obsidian mode is already enabled. Want to re-run migration? (Safe to run multiple times)"
  • •If user says no, exit
  • •If user says yes, continue to Step 3 (skip Step 2)

If not enabled:

  • •Continue to Step 2

Step 2: Explain Obsidian Integration

Say: "This will enable Obsidian mode in your Dex vault:

What changes:

  • •All person/company/project references become clickable wiki links
  • •Example: John_Doe → [[John_Doe]]
  • •Your existing files will be converted automatically

What stays the same:

  • •File structure (PARA folders)
  • •File contents (just adds [[ ]] around references)
  • •All MCP functionality

Time estimate: I'll scan your vault first and show you exactly how long it will take.

Safety: I'll create a git backup before any changes. Easy to revert if needed.

Ready to proceed?"

If NO: Say "No problem! You can run /dex-obsidian-setup anytime." and exit.

If YES: Continue to Step 3

Step 3: Run Migration

Call the migration script using Shell tool:

bash
cd /Users/dave/Dex/Dex
python core/obsidian/migrate_to_wikilinks.py

The script handles:

  • •Estimation and user confirmation
  • •Git backup
  • •Progress tracking
  • •macOS notification on completion
  • •Error handling

Wait for the script to complete and show the output to the user.

Step 4: Update User Profile

Update System/user-profile.yaml to set obsidian_mode: true:

  1. •Read the current file
  2. •Use StrReplace to update the obsidian_mode field (or add it if missing)
  3. •If the file uses YAML format, preserve the structure

Step 5: Optional - Generate Obsidian Config

Ask: "Want me to generate an Obsidian configuration optimized for Dex? This includes:

  • •Recommended settings (wiki link format, auto-update links)
  • •Hotkeys for common actions (Cmd+G for graph view)
  • •Workspace layout (file explorer + backlinks)

These are stored in .obsidian/ and only affect Obsidian (not Cursor/terminal)."

If YES:

Run the config generator:

bash
cd /Users/dave/Dex/Dex
python core/obsidian/generate_obsidian_config.py

Say: "✅ Obsidian config generated! Open your vault in Obsidian to see the optimized setup."

If NO:

Say: "No problem! You can always run this later with python core/obsidian/generate_obsidian_config.py"

Step 6: Optional - Start Sync Daemon

Ask: "Want to enable bidirectional sync? This keeps task checkboxes synced between Obsidian and Dex:

  • •Check a task in Obsidian → syncs to Tasks.md, person pages, meeting notes
  • •Check a task in Cursor → syncs to Obsidian

Runs in background, zero maintenance."

If YES:

Run the daemon installer (note: this will be created in Phase 4):

bash
cd /Users/dave/Dex/Dex
bash core/obsidian/install_sync_daemon.sh

If NO:

Say: "No problem! You can enable it later by running bash core/obsidian/install_sync_daemon.sh"

Step 7: Completion

Say: "✅ Obsidian mode enabled!

Next steps:

  1. •Open Obsidian: File → Open Folder → /Users/dave/Dex/Dex (or your Dex path)
  2. •Check the graph view: Ctrl/Cmd + G
  3. •Click any wiki link to navigate

Tips:

  • •Graph filters: Focus on specific areas (People, Projects)
  • •Search: Cmd/Ctrl + O for quick open
  • •Backlinks pane: See everywhere a note is referenced

Resources:

  • •See 06-Resources/Dex_System/Obsidian_Guide.md for detailed tips
  • •Watch the beginner's guide if you're new to Obsidian

You can still use Dex in Cursor/terminal exactly as before. Wiki links work everywhere."

Notes

  • •This skill is safe to run multiple times (idempotent)
  • •Migration creates a git backup before making changes
  • •Revert anytime with git reset --hard HEAD~1
  • •Works with vaults of any size (10K+ files tested)