Agent skill

Dex Obsidian Setup

by davekilleen in davekilleen/Dex

Turn on Obsidian mode and migrate the vault to wiki links. An agent skill from davekilleen/Dex.

MITAuto-check passedKnowledge Management

Install Dex Obsidian Setup

skills CLI
$ npx skills add davekilleen/Dex --skill dex-obsidian-setup -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install davekilleen/Dex dex-obsidian-setup --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/davekilleen/Dex.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/dex-obsidian-setup .claude/skills/dex-obsidian-setup && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
dex-obsidian-setup
GitHub stars
493
Token cost
~1.2k tokens
SKILL.md length
603 words
Files
1
Skills in repo
61
Repo updated
First seen
Licence
MIT

At a glance

Turn on Obsidian mode and migrate the vault to wiki links. An agent skill from davekilleen/Dex.

  • Works in 7 steps: Check Current State → Explain Obsidian Integration → Run Migration → …
  • The user says I use Obsidian
  • SKILL.md covers Purpose, Step 1: Check Current State, Step 2: Explain Obsidian… and Step 3: Run Migration, plus 6 more sections
  • Calls python, bash and git

What it does

Dex Obsidian Setup is an agent skill from davekilleen/Dex. Turn on Obsidian mode and migrate the vault to wiki links. Use when the user says 'I use Obsidian', 'enable wiki links', 'make this work in Obsidian'. Not for connecting an external tool/API; use create-mcp/integrate-mcp.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Knowledge Management. It works with Obsidian and Model Context Protocol. The repository describes itself as: Your AI Chief of Staff — a personal operating system starter kit that adapts to your role. No coding required. The licence is MIT.

When your agent uses it

  • The user says I use Obsidian
  • Enable wiki links
  • Make this work in Obsidian

Example prompts

  • “I use Obsidian”
  • “enable wiki links”
  • “make this work in Obsidian”
  • “/dex-obsidian-setup”

Requirements

  • Python 3

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Check Current State
  2. Explain Obsidian Integration
  3. Run Migration
  4. Update User Profile
  5. Optional - Generate Obsidian Config
  6. Optional - Start Sync Daemon
  7. Completion

What it can do on your machine

Read from SKILL.md and the folder at commit 227f78e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python
    • bash
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • youtube.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Dex Obsidian Setup loads about 1.2k tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 603 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~61
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from davekilleen/Dex at commit 227f78e, republished under its MIT licence (© davekilleen). 603 words, ~1,210 tokens.

Download SKILL.mdSave it as .claude/skills/dex-obsidian-setup/SKILL.md (or your agent's skills folder).
name
dex-obsidian-setup
description
Turn on Obsidian mode and migrate the vault to wiki links. Use when the user says 'I use Obsidian', 'enable wiki links', 'make this work in Obsidian'. Not for connecting an external tool/API; use `create-mcp`/`integrate-mcp`.
<!-- Generated from `.claude/skills/dex-obsidian-setup/SKILL.md` by `scripts/generate-agents-skills.py`. Do not edit. -->

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 (run from the vault root directory):

bash
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 (from vault root):

bash
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"

Show full SKILL.md (264 more words)Show less

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 (from vault root):

bash
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 → select your Dex vault folder
  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)

Track Usage (Silent)

Call the mark_feature_used tool on the dex-analytics MCP server with dex-obsidian-setup. This ticks the feature's box in System/usage_log.md, which is what /dex-level-up reads to recommend features that have not been tried. It writes locally and sends nothing, so it runs whether or not analytics is enabled.

Analytics (Silent):

Call track_event with event_name obsidian_enabled (no properties).

This only fires if the user has opted into analytics. No action needed if it returns "analytics_disabled".

© davekilleen, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/dex-obsidian-setup of davekilleen/Dex.

Open the folder on GitHubat commit 227f78e

Compare with similar skills

Dex Obsidian Setup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Dex Obsidian Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dex Obsidian Setup this skilldavekilleen/Dex493—~1.2kAutomated safety check: PassMIT
LLM Wikizosmaai/pi-llm-wiki608—~4.4kAutomated safety check: PassMIT
Sage Wikixoai/sage-wiki622—~2.4kAutomated safety check: PassMIT
Confluence To Markdowniurykrieger/claude-bedrock1051 repos~2.8kAutomated safety check: NotesMIT
Anytype Importpricklywiggles/niamos192—~3.3kAutomated safety check: PassNone
AI BrainOotto-AI/claude-content-skills122—~1.1kAutomated safety check: PassMIT

Similar skills

  • LLM Wiki

    zosmaai/pi-llm-wiki

    Build and maintain a persistent, interlinked Obsidian-compatible markdown wiki using Karpathy's LLM Wiki pattern.

    608 GitHub stars~4.4k tokensUpdated 2 days ago
    Knowledge ManagementAuto-check passed
  • Sage Wiki

    xoai/sage-wiki

    Reference skill for sage-wiki — local-first knowledge graph with MCP server, REST API, compiled wiki, and Obsidian-compatible output.

    622 GitHub stars~2.4k tokensUpdated 3 days ago
    Knowledge ManagementAuto-check passed
  • Confluence To Markdown

    iurykrieger/claude-bedrock

    Internal fetcher module for Confluence pages. An agent skill from iurykrieger/claude-bedrock.

    105 GitHub starsUsed in 1 repo~2.8k tokens
    Knowledge ManagementAuto-check: notes
  • Anytype Import

    pricklywiggles/niamos

    Import a page from the user's self-hosted Anytype into this Niamos Obsidian vault, page-by-page, recursing into children only when the user explicitly says so.

    192 GitHub stars~3.3k tokensUpdated 3 mo ago
    Knowledge ManagementAuto-check passed
  • AI Brain

    Ootto-AI/claude-content-skills

    Give Claude a permanent, searchable long-term memory using an Obsidian vault as the store.

    122 GitHub stars~1.1k tokensUpdated yesterday
    Knowledge ManagementAuto-check passed
  • Obsidian Project Memory

    brycewang-stanford/Auto-Empirical-Research-Skills

    This skill should be used when the user asks to maintain an Obsidian knowledge base for a research project, import an existing research repository into Obsidian, keep project memory or daily notes…

    4.5k GitHub stars~2.4k tokensUpdated 4 days ago
    Knowledge ManagementAuto-check passed

More from davekilleen/Dex

All 61 skills in this repo
  • Dspy Ruby

    davekilleen/Dex

    This skill should be used when working with DSPy.rb, a Ruby framework for building type-safe, composable LLM applications.

    493 GitHub starsUsed in 1 repo~3.9k tokens
    Auto-check passed
  • Diff Adopt Profile

    davekilleen/Dex

    Adopt a full published Heydex profile by handle ('set me up like @davekilleen').

    493 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Diff Generate

    davekilleen/Dex

    Package one workflow — how you use Dex for a specific job — into a shareable DexDiff methodology doc.

    493 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Creating Agent Skills

    davekilleen/Dex

    Expert guidance for creating, writing, and refining Claude Code Skills.

    493 GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • Feedback

    davekilleen/Dex

    Report a Dex bug to the Dex team with zero homework — Dex investigates locally, builds a privacy-safe report, shows it to you (or auto-sends if you've chosen that), and tracks the ticket until it's…

    493 GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Dhh Rails Style

    davekilleen/Dex

    This skill should be used when writing Ruby and Rails code in DHH's distinctive 37signals style.

    493 GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed

Questions about Dex Obsidian Setup

What does Dex Obsidian Setup do?

Turn on Obsidian mode and migrate the vault to wiki links. An agent skill from davekilleen/Dex. Dex Obsidian Setup is an agent skill from davekilleen/Dex. Turn on Obsidian mode and migrate the vault to wiki links.

When should I use Dex Obsidian Setup?

Dex Obsidian Setup fits situations like: the user says I use Obsidian; enable wiki links; make this work in Obsidian.

How do I install Dex Obsidian Setup in Claude Code?

Run `npx skills add davekilleen/Dex --skill dex-obsidian-setup -a claude-code`. Or copy the skill folder (.agents/skills/dex-obsidian-setup in davekilleen/Dex) into .claude/skills/dex-obsidian-setup in your project. Claude Code loads it when a task matches its description.

How do I install Dex Obsidian Setup in Codex?

Run `npx skills add davekilleen/Dex --skill dex-obsidian-setup -a codex`. Or copy the skill folder (.agents/skills/dex-obsidian-setup in davekilleen/Dex) into .agents/skills/dex-obsidian-setup in your project. Codex loads it when a task matches its description.

Can I use Dex Obsidian Setup in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add davekilleen/Dex --skill dex-obsidian-setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dex-obsidian-setup, .gemini/skills/dex-obsidian-setup, .github/skills/dex-obsidian-setup and .opencode/skills/dex-obsidian-setup in your project.

What does Dex Obsidian Setup need to run?

Going by SKILL.md and its folder, Dex Obsidian Setup needs the command-line tools its instructions call (python, bash and git). Our summary lists: Python 3.

Does Dex Obsidian Setup access the network?

SKILL.md names 1 domain. As links in the text: youtube.com. This is read from the text; nothing was executed.

Is Dex Obsidian Setup safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Dex Obsidian Setup use?

Dex Obsidian Setup is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dex Obsidian Setup use?

About 1.2k tokens (SKILL.md is roughly 4.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Dex Obsidian Setup?

Skills that share tags, products or a category with Dex Obsidian Setup: LLM Wiki (zosmaai/pi-llm-wiki, 608 stars), Sage Wiki (xoai/sage-wiki, 622 stars), Confluence To Markdown (iurykrieger/claude-bedrock, 105 stars) and Anytype Import (pricklywiggles/niamos, 192 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dex Obsidian Setup?

davekilleen (a GitHub user) maintains it in davekilleen/Dex, which has 493 GitHub stars. The repository holds 61 skills in this directory. The repository was last updated on October 8, 2026.

Source: davekilleen/Dex on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.