Agent skill

Vault Methodology Router

by AgriciDaniel in AgriciDaniel/claude-obsidian

Reads or changes an Obsidian vault's filing methodology, Generic, LYT, PARA or Zettelkasten, and suggests where planned notes should go without saving or moving anything.

MITAuto-check passedKnowledge Management

Install Vault Methodology Router

skills CLI
$ npx skills add AgriciDaniel/claude-obsidian --skill wiki-mode -a claude-code

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

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

At a glance

Reads or changes an Obsidian vault's filing methodology, Generic, LYT, PARA or Zettelkasten, and suggests where planned notes should go without saving or moving anything.

  • Works in 6 steps: Read the current .vault-meta/mode.json,… → Validate the requested mode as exactly… → Choose and retain a pinned UTC timestamp… → …
  • Checking which filing methodology a vault is currently set to
  • SKILL.md covers Read and route safely, Change mode and Checkpoint
  • Calls python3

What it does

The skill reports which methodology a vault uses and proposes destinations for knowledge about to be created. The mode lives in .vault-meta/mode.json: a missing file means generic, while an invalid one makes the skill stop and repair it through a reviewed configuration step instead of quietly falling back. A helper script is always given the vault explicitly and only prints suggestions, never writes pages or moves existing notes.

Routing follows the mode. Generic uses type-based folders such as sources, entities, concepts and sessions; lyt puts atomic notes under wiki/notes connected through maps of content; para picks among projects, areas, resources and archives by actionability; zettelkasten uses flat atomic notes with sortable identifiers and explicit links. Changing mode is one configuration operation, previewed as a dry run first, and the bundled LYT, PARA and Zettelkasten templates are guidance, not permission to overwrite your own conventions.

When your agent uses it

  • Checking which filing methodology a vault is currently set to
  • Switching a vault between generic, LYT, PARA and Zettelkasten modes
  • Deciding where a planned new note belongs under the active methodology

Example prompts

  • “What is my vault mode right now?”
  • “Switch this vault to PARA and show me the dry run first.”
  • “Where should a new note about spaced repetition go in Zettelkasten mode?”

Requirements

  • An Obsidian vault with the claude-obsidian plugin installed
  • Python 3 for the mode helper script

Workflow steps

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

  1. Read the current .vault-meta/mode.json, or start from the helper's default
  2. Validate the requested mode as exactly generic, lyt, para, or
  3. Choose and retain a pinned UTC timestamp and operation ID for both commands.
  4. Preview the canonical configuration transaction; the command records the
  5. Show the old mode, new mode, exact changed path, and complete preview. Copy
  6. Apply by regenerating that exact vault-bound plan

What it can do on your machine

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

    • python3

    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 no API keys, tokens, secrets or passwords.

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

Context cost

Vault Methodology Router loads about 1k tokens when it runs. Until then it costs about 95 tokens; SKILL.md has 410 words of instructions outside code blocks.

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

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 AgriciDaniel/claude-obsidian at commit 32ac5a0, republished under its MIT licence (© AgriciDaniel). 410 words, ~1,046 tokens.

Download SKILL.mdSave it as .claude/skills/wiki-mode/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
wiki-mode
description
Read or configure the vault filing methodology and suggest destinations for planned knowledge creation under Generic, LYT, PARA, or Zettelkasten. Use for wiki mode, methodology mode, what is my vault mode, set vault mode, switch to PARA, use LYT, Zettelkasten setup, change mode, configure mode, or methodology routing. This skill does not save content or migrate notes.

Route by vault methodology

This skill returns filing suggestions. It does not write knowledge pages or move existing notes. If .vault-meta/mode.json is absent, use generic. If the file exists but is invalid, fail closed and repair it through a reviewed configuration operation before suggesting routes; never silently substitute Generic for corrupt user configuration.

Resolve the installed product root from this skill's own location, not from the vault or current working directory:

bash
PRODUCT_ROOT=/absolute/path/to/installed/claude-obsidian
CORE="$PRODUCT_ROOT/scripts/claude-obsidian.py"
MODE_HELPER="$PRODUCT_ROOT/scripts/wiki-mode.py"
test -f "$CORE" && test -f "$MODE_HELPER"

Every ../wiki/references/ link in this file resolves the same way, relative to this skill's own directory under $PRODUCT_ROOT, never relative to the selected vault's wiki/ directory.

Read and route safely

Always select the vault explicitly:

bash
python3 "$MODE_HELPER" --vault "$VAULT" get
python3 "$MODE_HELPER" --vault "$VAULT" config
python3 "$MODE_HELPER" --vault "$VAULT" route concept "Concept name"
python3 "$MODE_HELPER" --vault "$VAULT" route source "Source title"

The helper validates the selected vault, confines paths, sanitizes names, and prints a suggestion only. A calling skill may override the suggestion when the user supplies a more specific project, area, MOC, or parent note, but it must still apply its eventual writes through one operation transaction.

ModeRouting intent
genericType-based folders such as sources, entities, concepts, and sessions.
lytAtomic notes under wiki/notes/, connected through MOCs.
paraProjects, Areas, Resources, or Archives chosen by actionability.
zettelkastenFlat atomic notes with time-sortable, collision-resistant identifiers and explicit links.

Use the templates under templates/ as structural guidance, not authority to overwrite user conventions.

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

Change mode

A mode change is one configuration operation, dry-run first:

  1. Read the current .vault-meta/mode.json, or start from the helper's default config when it is absent.

  2. Validate the requested mode as exactly generic, lyt, para, or zettelkasten. Preserve the other mode-specific settings.

  3. Choose and retain a pinned UTC timestamp and operation ID for both commands.

  4. Preview the canonical configuration transaction; the command records the current target hash and limits the write to .vault-meta/mode.json:

    bash
    python3 "$CORE" mode set "$MODE" --vault "$VAULT" \
      --generated-at "$GENERATED_AT" --operation-id "$OPERATION_ID"
  5. Show the old mode, new mode, exact changed path, and complete preview. Copy its approved_plan_sha256 only after review.

  6. Apply by regenerating that exact vault-bound plan:

    bash
    python3 "$CORE" mode set "$MODE" --vault "$VAULT" \
      --generated-at "$GENERATED_AT" --operation-id "$OPERATION_ID" \
      --approved-plan-sha256 "$APPROVAL_SHA256" --apply

Follow the operation transaction contract. Do not use scripts/wiki-mode.py's legacy direct-write set action or a setup script to bypass this workflow.

Changing mode affects routing for future operations only. Never bulk-create folders, move notes, rewrite wikilinks, or migrate existing pages as a side effect. If migration is later requested, plan and review it as a distinct operation with its own hashes and transaction.

Checkpoint

Observe the user's current structure, think about how they retrieve and act on notes, verify a few proposed routes before changing configuration, and grow by revisiting the mode only when real filing friction appears.

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

Files

SKILL.md and 6 other files in skills/wiki-mode of AgriciDaniel/claude-obsidian.

  • SKILL.md
  • templates/lyt/atomic-template.md
  • templates/lyt/moc-template.md
  • templates/para/area-template.md
  • templates/para/project-template.md
  • templates/para/resource-template.md
  • templates/zettel/atomic-template.md

Open the folder on GitHubat commit 32ac5a0

Compare with similar skills

Vault Methodology Router 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.

Vault Methodology Router compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Vault Methodology Router this skillAgriciDaniel/claude-obsidian15k—~1kAutomated safety check: PassMIT
Obsidian Project Knowledge BaseGalaxy-Dawn/claude-scholar5.7k—~551Automated safety check: PassMIT
Ray Obsidian Vault Setupimraywang/rayskills160—~625Automated safety check: PassCustom licence
LLM Wikilewislulu/llm-wiki-skill655—~3.7kAutomated safety check: PassNone
My LLM WikiMartinLwx/dotfiles140—~2.7kAutomated safety check: PassNone
Obsidian Knowledge BuilderMichael-OvO/obsidian-knowledge-agent205—~917Automated safety check: PassMIT

Similar skills

  • Obsidian Project Knowledge Base

    Galaxy-Dawn/claude-scholar

    Maintains a project-scoped Obsidian research knowledge base: bootstrapping its folders, routing notes, updating hub, plan and index notes, and linting.

    5.7k GitHub stars~551 tokensUpdated 15 days ago
    Knowledge ManagementAuto-check passed
  • Ray Obsidian Vault Setup

    imraywang/rayskills

    Sets up, audits or incrementally upgrades a local Obsidian vault for knowledge work and content production, without overwriting or moving existing notes.

    160 GitHub stars~625 tokensUpdated 15 days ago
    Knowledge ManagementAuto-check passed
  • 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
  • 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 19 days ago
    Knowledge ManagementAuto-check passed
  • Obsidian Knowledge Builder

    Michael-OvO/obsidian-knowledge-agent

    Turns PDFs, slides, syllabi, papers and transcripts into structured, teaching-quality Obsidian notes, matching how much structure is built to how much the material needs.

    205 GitHub stars~917 tokensUpdated 3 mo ago
    Knowledge ManagementAuto-check passed
  • LLM Wiki

    CharlesHoskinson/sevenlayer

    Builds and maintains a persistent, interlinked Obsidian-compatible markdown knowledge wiki in a git repo via three operations — ingest a source into linked pages, answer a question from the…

    116 GitHub stars~1.5k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check passed

More from AgriciDaniel/claude-obsidian

All 15 skills in this repo
  • Bounded Autoresearch

    AgriciDaniel/claude-obsidian

    Runs a bounded, source-grounded research loop that drafts a cited dossier and can propose a separately reviewed merge into an Obsidian vault.

    15k GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • Obsidian Wiki Log Fold

    AgriciDaniel/claude-obsidian

    Creates a bounded, extractive rollup of recent Obsidian wiki log entries, previewed by default, with one optional apply step and no changes to child pages.

    15k GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check passed
  • Obsidian Canvas Boards

    AgriciDaniel/claude-obsidian

    Creates, inspects and updates Obsidian JSON Canvas boards in a vault, with text, file, link, group and edge nodes, using safe recoverable edits.

    15k GitHub stars~1.4k tokensUpdated 28 days ago
    Auto-check passed
  • Defuddle Web Page Cleaner

    AgriciDaniel/claude-obsidian

    Plans, and with explicit network consent runs, an external Defuddle extractor that turns an article-like HTTPS page into clean Markdown for later wiki ingestion.

    15k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Obsidian Wiki Vault Setup

    AgriciDaniel/claude-obsidian

    Sets up or adopts a separate Obsidian knowledge vault through the claude-obsidian core script and routes follow-up work to the right wiki sub-skill.

    15k GitHub stars~1.3k tokensUpdated 28 days ago
    Auto-check passed
  • Save to Obsidian Vault

    AgriciDaniel/claude-obsidian

    Files a specific answer, decision or insight you point to in a conversation as one reviewed note in your Obsidian vault, and only when you ask for it.

    15k GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed

Works with

Questions about Vault Methodology Router

What does Vault Methodology Router do?

Reads or changes an Obsidian vault's filing methodology, Generic, LYT, PARA or Zettelkasten, and suggests where planned notes should go without saving or moving anything. The skill reports which methodology a vault uses and proposes destinations for knowledge about to be created.json: a missing file means generic, while an invalid one makes the skill stop and repair it through a reviewed configuration step instead of quietly falling back.

When should I use Vault Methodology Router?

Vault Methodology Router fits situations like: checking which filing methodology a vault is currently set to; switching a vault between generic, LYT, PARA and Zettelkasten modes; deciding where a planned new note belongs under the active methodology.

How do I install Vault Methodology Router in Claude Code?

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

How do I install Vault Methodology Router in Codex?

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

Can I use Vault Methodology Router 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 AgriciDaniel/claude-obsidian --skill wiki-mode -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-mode, .gemini/skills/wiki-mode, .github/skills/wiki-mode and .opencode/skills/wiki-mode in your project.

What does Vault Methodology Router need to run?

Going by SKILL.md and its folder, Vault Methodology Router needs the command-line tools its instructions call (python3). Our summary lists: An Obsidian vault with the claude-obsidian plugin installed; Python 3 for the mode helper script.

Does Vault Methodology Router 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 Vault Methodology Router 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 Vault Methodology Router use?

Vault Methodology Router 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 Vault Methodology Router use?

About 1k tokens (SKILL.md is roughly 4.2k 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 Vault Methodology Router?

Skills that share tags, products or a category with Vault Methodology Router: Obsidian Project Knowledge Base (Galaxy-Dawn/claude-scholar, 5.7k stars), Ray Obsidian Vault Setup (imraywang/rayskills, 160 stars), LLM Wiki (lewislulu/llm-wiki-skill, 655 stars) and My LLM Wiki (MartinLwx/dotfiles, 140 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Vault Methodology Router?

AgriciDaniel (a GitHub user) maintains it in AgriciDaniel/claude-obsidian, which has 15,399 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on September 10, 2026.

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