Agent skill

Wiki Switch

by Ar9av in Ar9av/obsidian-wiki

List, create, or switch named Obsidian wiki vault profiles under the global config directory.

MITAuto-check passedKnowledge Management

Install Wiki Switch

skills CLI
$ npx skills add Ar9av/obsidian-wiki --skill wiki-switch -a claude-code

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

GitHub CLI
$ gh skill install Ar9av/obsidian-wiki wiki-switch --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/Ar9av/obsidian-wiki.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.skills/wiki-switch .claude/skills/wiki-switch && 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
wiki-switch
GitHub stars
3.5k
Token cost
~1.3k tokens
SKILL.md length
559 words
Files
1
Skills in repo
39
Repo updated
First seen
Licence
MIT

At a glance

List, create, or switch named Obsidian wiki vault profiles under the global config directory.

  • Works in 4 steps: Verify $CONFIG_DIR/config. exists. If… → Run → Read OBSIDIAN_VAULT_PATH from the newly… → …
  • Changing the active vault
  • SKILL.md covers Dispatch, Switch (default action), List and Show, plus 1 more section
  • Calls vault; needs API_KEY

What it does

Wiki Switch is an agent skill from Ar9av/obsidian-wiki. List, create, or switch named Obsidian wiki vault profiles under the global config directory. Use when changing the active vault, checking which vault is active, or managing multi-vault profiles.

Its SKILL.md is about 1.3k 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, covering LLM wikis. It works with Obsidian. The repository describes itself as: Framework for AI agents to build and maintain a digital brain through Obsidian wiki | Memory System for Agents. The licence is MIT.

When your agent uses it

  • Changing the active vault
  • Checking which vault is active
  • Managing multi-vault profiles

Example prompts

  • “/wiki-switch”

Requirements

  • A credential in API_KEY

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Verify $CONFIG_DIR/config. exists. If not, tell the user the vault doesn't exist and list what's available (run List).
  2. Run
  3. Read OBSIDIAN_VAULT_PATH from the newly active config.
  4. Confirm to the user

What it can do on your machine

Read from SKILL.md and the folder at commit 709727e. 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:

    • vault

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • API_KEY

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

Context cost

Wiki Switch loads about 1.3k tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 559 words of instructions outside code blocks.

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

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 Ar9av/obsidian-wiki at commit 709727e, republished under its MIT licence (© Ar9av). 559 words, ~1,260 tokens.

Download SKILL.mdSave it as .claude/skills/wiki-switch/SKILL.md (or your agent's skills folder).
name
wiki-switch
description
List, create, or switch named Obsidian wiki vault profiles under the global config directory. Use when changing the active vault, checking which vault is active, or managing multi-vault profiles.

Wiki Switch — Manage Multiple Vault Profiles

Global config dir. Every path below is relative to the global config dir, resolved per the Config Resolution Protocol in llm-wiki/SKILL.md: $XDG_CONFIG_HOME/obsidian-wiki (default ~/.config/obsidian-wiki), or the legacy ~/.obsidian-wiki if that already exists on disk. Resolve it once per invocation with:

bash
CONFIG_DIR="$( [[ -d "$HOME/.obsidian-wiki" && ! -e "${XDG_CONFIG_HOME:-$HOME/.config}/obsidian-wiki" ]] && echo "$HOME/.obsidian-wiki" || echo "${XDG_CONFIG_HOME:-$HOME/.config}/obsidian-wiki" )"

Each vault is a complete config file at $CONFIG_DIR/config.<name>. The active vault is whichever file $CONFIG_DIR/config symlinks to. Switching vaults means re-pointing that symlink.

Switch vs. inline targeting. /wiki-switch <name> changes your persistent default (re-points the symlink, affecting all future requests). To touch a different vault for just one request without changing your default, use the inline @name override in any request (e.g. @work save this, wiki-query @personal about X). The @name override is handled by the Config Resolution Protocol in llm-wiki/SKILL.md, not by this skill — it resolves $CONFIG_DIR/config.<name> for that one invocation and never re-points the symlink.

Dispatch

Parse the invocation and route to the right section:

InvocationAction
/wiki-switch <name>→ Switch
/wiki-switch list→ List
/wiki-switch show [name]→ Show
/wiki-switch new <name>→ New
/wiki-switch (no args)→ List (treat as list)
@<name> … (inline, in any request)→ Not this skill — the Config Resolution Protocol resolves that vault for one invocation without re-pointing the symlink

Switch (default action)

Activate a named vault profile.

  1. Verify $CONFIG_DIR/config.<name> exists. If not, tell the user the vault doesn't exist and list what's available (run List).
  2. Run:
    bash
    ln -sf "$CONFIG_DIR/config.<name>" "$CONFIG_DIR/config"
  3. Read OBSIDIAN_VAULT_PATH from the newly active config.
  4. Confirm to the user:
    Switched to vault: <name>
    Vault path: <value of OBSIDIAN_VAULT_PATH from the config>

List

Show all registered vault profiles and which is active.

  1. Find all files matching $CONFIG_DIR/config.* (exclude config itself — that's the symlink).
  2. Resolve the current symlink target: readlink "$CONFIG_DIR/config"
  3. For each config file, read the first non-empty comment line (lines starting with #) as a human description of the vault. Fall back to the file's suffix as the label if no comment exists.
  4. Display:
    Vaults:
      personal   My personal research wiki    ← active
      work       Work projects wiki
    Mark the active one with ← active. If the symlink is broken or config doesn't exist, show (none active).

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

Show

Print the full config for a vault.

  • If a name is given, read $CONFIG_DIR/config.<name>.
  • If no name given, read $CONFIG_DIR/config (the active vault).
  • If the file doesn't exist, tell the user and list what's available.
  • Print the file contents verbatim (redact any lines containing API_KEY or SECRET — show *** instead of the value).

New

Scaffold a new vault config from the current active config as a template.

  1. Check $CONFIG_DIR/config.<name> doesn't already exist. Abort if it does.
  2. Copy the active config:
    bash
    cp "$CONFIG_DIR/config" "$CONFIG_DIR/config.<name>"
  3. Read the copied config. Config files use # --- Section name --- comment headers to group fields into sections (e.g., # --- Vault-specific ---, # --- Vault-independent ---, # --- Secrets ---). Use these sections to determine what to ask about:
    • Fields in sections labeled "vault-specific", "paths", or similar → ask the user for new values
    • Fields in sections labeled "vault-independent", "global", "shared" → keep as-is (copy over unchanged)
    • Fields in sections labeled "secrets" → ask if the new vault uses the same credentials or different ones
    • If there are no section headers, present all fields and let the user decide which to change
  4. Ask the user for updated values for the vault-specific fields. Use the current values as visible defaults — the user only needs to supply what differs.
  5. Write the updated values into $CONFIG_DIR/config.<name>.
  6. Update the top comment line to describe the new vault (e.g., # Obsidian Wiki — <name> vault).
  7. Confirm:
    Created: $CONFIG_DIR/config.<name>
    Run `/wiki-switch <name>` to activate it, then run `wiki-setup` to initialise the new vault.
    Do not switch automatically — let the user decide when to activate.

© Ar9av, 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 .skills/wiki-switch of Ar9av/obsidian-wiki.

Open the folder on GitHubat commit 709727e

Compare with similar skills

Wiki Switch 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.

Wiki Switch compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Wiki Switch this skillAr9av/obsidian-wiki3.5k—~1.3kAutomated safety check: PassMIT
LLM Wikilewislulu/llm-wiki-skill655—~3.7kAutomated safety check: PassNone
Obsidian CLI Read TransportAgriciDaniel/claude-obsidian15k1 repos~762Automated safety check: PassMIT
LLM Wikizosmaai/pi-llm-wiki606—~4.4kAutomated safety check: PassMIT
LLM Wikipraneybehl/llm-wiki-plugin118—~5.7kAutomated safety check: PassMIT
Karpathy WikiSherwinQ/karpathy-wiki113—~967Automated safety check: PassMIT

Similar skills

  • LLM Wiki

    lewislulu/llm-wiki-skill

    Build and maintain a Karpathy-style LLM knowledge base — a self-compiling Obsidian markdown wiki where an Agent ingests raw sources, compiles cross-linked concept/entity/summary pages, answers…

    655 GitHub stars~3.7k tokensUpdated 5 mo ago
    Knowledge ManagementAuto-check passed
  • Obsidian CLI Read Transport

    AgriciDaniel/claude-obsidian

    Detects and uses the official Obsidian command-line interface for read-only vault access, falling back to direct file reads, while all mutations stay on a separate transaction core.

    15k GitHub starsUsed in 1 repo~762 tokens
    Knowledge ManagementAuto-check passed
  • LLM Wiki

    zosmaai/pi-llm-wiki

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

    606 GitHub stars~4.4k tokensUpdated yesterday
    Knowledge ManagementAuto-check passed
  • LLM Wiki

    praneybehl/llm-wiki-plugin

    Build and maintain an LLM-curated knowledge base from papers, articles, transcripts, notes and project findings.

    118 GitHub stars~5.7k tokensUpdated 25 days ago
    Knowledge ManagementAuto-check passed
  • Karpathy Wiki

    SherwinQ/karpathy-wiki

    A skill your agent uses when building or maintaining a personal knowledge base with LLM assistance.

    113 GitHub stars~967 tokensUpdated 5 mo ago
    Knowledge ManagementAuto-check passed
  • My LLM Wiki

    MartinLwx/dotfiles

    Provides access to the user's personal wiki, including notes, research, project documentation, decisions, and archived knowledge.

    140 GitHub stars~2.7k tokensUpdated 18 days ago
    Knowledge ManagementAuto-check passed

More from Ar9av/obsidian-wiki

All 39 skills in this repo
  • Hermes History Ingest

    Ar9av/obsidian-wiki

    Ingest Hermes agent history into Obsidian as distilled knowledge.

    3.5k GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check: notes
  • Codex History Ingest

    Ar9av/obsidian-wiki

    Ingest Codex CLI conversation/session history into Obsidian as distilled knowledge.

    3.5k GitHub stars~2.2k tokensUpdated yesterday
    Auto-check: notes
  • Copilot History Ingest

    Ar9av/obsidian-wiki

    Ingest GitHub Copilot CLI/session history into Obsidian as distilled knowledge.

    3.5k GitHub stars~4.4k tokensUpdated yesterday
    Auto-check: notes
  • Obsidian Layout Adjustment

    Ar9av/obsidian-wiki

    Adjust the user's Obsidian visual layout with CSS snippets. An agent skill from Ar9av/obsidian-wiki.

    3.5k GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed
  • Openclaw History Ingest

    Ar9av/obsidian-wiki

    Ingest OpenClaw session/history data into Obsidian as distilled knowledge.

    3.5k GitHub stars~2.5k tokensUpdated yesterday
    Auto-check: notes
  • Wiki Capture

    Ar9av/obsidian-wiki

    Turn the current conversation or finding into a structured permanent wiki note.

    3.5k GitHub stars~4.3k tokensUpdated yesterday
    Auto-check: notes

Works with

Questions about Wiki Switch

What does Wiki Switch do?

List, create, or switch named Obsidian wiki vault profiles under the global config directory. Wiki Switch is an agent skill from Ar9av/obsidian-wiki. List, create, or switch named Obsidian wiki vault profiles under the global config directory.

When should I use Wiki Switch?

Wiki Switch fits situations like: changing the active vault; checking which vault is active; managing multi-vault profiles.

How do I install Wiki Switch in Claude Code?

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

How do I install Wiki Switch in Codex?

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

Can I use Wiki Switch 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 Ar9av/obsidian-wiki --skill wiki-switch -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/wiki-switch, .gemini/skills/wiki-switch, .github/skills/wiki-switch and .opencode/skills/wiki-switch in your project.

What does Wiki Switch need to run?

Going by SKILL.md and its folder, Wiki Switch needs the command-line tools its instructions call (vault) and credentials named API_KEY. Our summary lists: A credential in API_KEY.

Does Wiki Switch access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Wiki Switch 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 Wiki Switch use?

Wiki Switch 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 Wiki Switch use?

About 1.3k tokens (SKILL.md is roughly 5k 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 Wiki Switch?

Skills that share tags, products or a category with Wiki Switch: LLM Wiki (lewislulu/llm-wiki-skill, 655 stars), Obsidian CLI Read Transport (AgriciDaniel/claude-obsidian, 15k stars), LLM Wiki (zosmaai/pi-llm-wiki, 606 stars) and LLM Wiki (praneybehl/llm-wiki-plugin, 118 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Wiki Switch?

Ar9av (a GitHub user) maintains it in Ar9av/obsidian-wiki, which has 3,532 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on October 7, 2026.

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