vault-scout

vault-scout is a skill for Claude Code, Codex from mm-weber/loremaester. It costs 147 tokens per session (2,553 once invoked), scanned A, original, MIT.

A helper for mechanically searching and reading Obsidian vault notes, which are Markdown files used for linked personal knowledge.

In plain words
What is it for?
Use it to find linked notes, list files, read frontmatter, search for patterns, and report structured results from an Obsidian vault.
Why use it?
It handles repetitive searches and tabulation across many notes so the main agent does not need to inspect them one by one.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions subagents.

Good fit Use it to find linked notes, list files, read frontmatter, search for patterns, and report structured results from an Obsidian vault.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/mm-weber/loremaester/vault-scout
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add mm-weber/loremaester --skill vault-scout
Clone the repo
git clone --depth 1 https://github.com/mm-weber/loremaester

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for vault-scout

README.md
[![agentmods](https://agentmods.dev/badge/skills/mm-weber/loremaester/vault-scout.svg)](https://agentmods.dev/skills/mm-weber/loremaester/vault-scout)
Your own site
<a href="https://agentmods.dev/skills/mm-weber/loremaester/vault-scout"><img src="https://agentmods.dev/badge/skills/mm-weber/loremaester/vault-scout.svg" alt="Measured on agentmods" height="20"></a>
Per session 147 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,553 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00147 $0.02553
Opus 5 $0.00073 $0.01277
Sonnet 5 $0.00029 $0.00511
Haiku 4.5 $0.00015 $0.00255

Measured 7d ago against content hash da625df5cb71, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

vault-scout scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

examples/ttrpg/skills/vault-scout/SKILL.md · 221 lines

How it starts

The opening of the file, as written. The whole thing — 221 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Vault Scout

A Haiku-backed primitive for mechanical Obsidian-vault exploration. The main agent calls this skill when it needs a structured answer to a search/listing/frontmatter question without polluting its own context with dozens of file reads.

Why this skill exists

Vault work frequently needs the same kind of mechanical sweep:

  • "Find every NPC linked to a given faction"
  • "List all notes under Sessions/Session N/ and their frontmatter types"
  • "Grep for [[Note Name]] across Locations/ and show which notes reference it"
  • "Read these 12 location notes and tell me which ones have no discovery: field"

These tasks are pattern-match + read + tabulate. No creative judgment, no prose generation. Letting the main Opus agent run them is wasteful: the main agent pays Opus prices for Haiku-grade work, and its context fills up with file contents it doesn't need beyond the tabulation.

vault-scout dispatches a Haiku subagent with the narrow question, lets Haiku do the scanning in its own context, and receives back a clean tabular or bulleted answer.

When to use

  • The task is find X / list Y / read frontmatter and tabulate / grep for pattern Z.
  • The answer is a table, bulleted list, or short structured summary — not prose, not creative content.
  • The work involves reading many files (≥5) or running pattern searches that would otherwise pollute main-agent context.
  • The rules for the task are fully determined by the request (no judgment calls beyond "does this match?").

When NOT to use

  • Creative work — NPC psychology, location design, scene architecture, prose writing. Main Opus owns these.
  • Single-file reads — one file, small, go direct. Dispatch overhead (~200 Opus tokens to write the prompt + ~80 Opus tokens to read the result) exceeds the work.
  • Simple Bash ops — file renames, git mv, mkdir. Main agent Bash is faster and cheaper.
  • Synthesis across sources — if the answer requires combining vault content with sourcebook content, that's a worldbuilding task. Use worldbuilding or related skills.
  • Tasks needing taste/judgment — "which NPC would work best for Session N?" is creative. Main Opus.

Read the full file on GitHub · 221 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 7d ago First seen · 221 lines · 147 tokens per session scan A da625df5cb71

Subscribe to this mod's changes

vault-scout is a skill published in the GitHub repository mm-weber/loremaester (19 stars, last pushed 1mo ago), licensed MIT. It adds 147 tokens to every session and 2,553 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

session-context-restore

A cross-session context-recovery skill that restores information about earlier work when a new conversation begins.

Linearl/reasonix_skill_repo · 54 tokens

migrate-reasonix-project

A documented process for moving Reasonix, Claude Code, or Codex project directories while preserving complete conversation history.

Linearl/reasonix_skill_repo · 30 tokens

wiki-retrieve

Build and query a vault-local contextual BM25 retrieval index with optional multilingual Nomic cosine reranking; use for retrieve, hybrid retrieval, BM25, rerank, contextual retrieval, chunk search, vault search, semantic search, find relevant passages, or retrieval diagnostics. Derived caches stay under .vault-meta…

AgriciDaniel/claude-obsidian · 81 tokens

obsidian-bases

Explain, draft, and validate Obsidian Bases .base files with filters, formulas, properties, summaries, and table, card, or list views. Use for Obsidian Bases, database-like vault views, dynamic tables, reading lists, task trackers, filters, formulas, summaries, and .base file edits.

AgriciDaniel/claude-obsidian · 69 tokens

wiki-import

Import a wiki knowledge graph into the current vault — either from a graph.json export file (stubs) or from an OKF (Open Knowledge Format) markdown bundle (full page bodies). Use this skill when the user says "import wiki", "import from export", "load graph.json", "import vault", "import OKF bundle", "import OKF"…

Ar9av/obsidian-wiki · 108 tokens

wiki-digest

Generate a periodic knowledge digest — a human-readable newsletter-style summary of what was learned, updated, and connected in your wiki over a specified period (day/week/month). Use when the user says "what did I learn this week", "give me a digest", "weekly summary", "knowledge report", "what's new in my wiki"…

Ar9av/obsidian-wiki · 121 tokens