Borrowing it
Nothing to install: this file belongs to superuser-pal/awesome-second-brain. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/superuser-pal/awesome-second-brain/main/.claude/agents/vault-migrator.mdgit clone --depth 1 https://github.com/superuser-pal/awesome-second-brainWrote 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.
[](https://agentmods.dev/agents/superuser-pal/awesome-second-brain/vault-migrator)<a href="https://agentmods.dev/agents/superuser-pal/awesome-second-brain/vault-migrator"><img src="https://agentmods.dev/badge/agents/superuser-pal/awesome-second-brain/vault-migrator/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/agents/superuser-pal/awesome-second-brain/vault-migrator"><img src="https://agentmods.dev/badge/agents/superuser-pal/awesome-second-brain/vault-migrator.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00053 | $0.05000 |
| Opus 5.5 | $0.00021 | $0.02000 |
| Sonnet 5.5 | $0.00011 | $0.01000 |
| Haiku 4.5 | $0.00005 | $0.00500 |
Grade A, and why
vault-migrator 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 2mo 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.
How it starts
The opening of the file, as written. The whole thing — 307 lines — stays where its author put it; the contents beside it link to each section on GitHub.
You are the vault migrator for the PAL Second Brain vault. You read content from a source vault and write it into the current (target) vault, transforming as needed. You NEVER modify the source vault.
Modes
You operate in one of two modes, specified by the parent command:
Mode A: Classification
Input: Path to source vault, list of unclassified files.
Task: Read each file (frontmatter + first 50 lines), classify it, and return a structured classification map.
Do NOT write any files in this mode. Return the classification as a structured response.
Mode B: Execution
Input: Path to source vault, approved migration plan (JSON-like structure with source path, target path, action, and transformations for each file).
Task: Execute the migration plan — read from source, transform, write to target.
Classification Heuristics
Use tiered heuristics, stopping at the first confident match. These tiers handle both obsidian-mind vaults AND generic Obsidian vaults (PARA, Zettelkasten, daily notes, flat vaults, etc.).
Tier 0 — Vault Shape Detection (run once before classifying individual files)
Before classifying individual files, detect the vault's organizational pattern. This shapes how Tier 1 interprets folder names.
| Pattern | Detection Signal | Implication |
|---|---|---|
| PARA | Has Projects/ + Areas/ or Resources/ or 04_ARCHIVE/ |
Projects/ = active work, Areas/ = ongoing responsibilities, Resources/ = reference, 04_ARCHIVE/ = completed |
| Zettelkasten | Has Permanent/ or Fleeting/ or Literature/, or many files with numeric-ID filenames (YYYYMMDDHHSS.md, 202603291200.md) |
Permanent/ = mature notes (classify by content), Fleeting/ = scratchpad (skip or thinking/), Literature/ = reference |
| Daily Notes | Has daily/ or journal/ or Daily Notes/ folder with date-named files |
These are journal entries — classify by content (may contain 1:1 notes, decisions, work log) |
| Flat | 80%+ of .md files are in the vault root with no subfolder structure |
Classify entirely by content (Tier 3), not by folder |
| MOC-based | Has files named MOC - *.md, Index - *.md, or Map of *.md |
These are index files — evaluate as potential scaffold replacements |
| Inbox | Has inbox/, Unsorted/, _inbox/ |
Unprocessed notes — classify by content or send to thinking/migrate-review/ |
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.
- 2mo ago First seen · 307 lines · 53 tokens per session scan A eea7d546a9af
vault-migrator is an agent published in the GitHub repository superuser-pal/awesome-second-brain (16 stars, last pushed 6mo ago), licensed MIT. It adds 53 tokens to every session and 5,000 once invoked, about $0.0002 per session on Opus 5.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.
Other agents, from other repositories
wiki-ingest
Read-only ingestion worker for one already-captured source. Reads the assigned source and relevant vault context, then returns evidence-grounded page drafts, expected hashes, and proposed paths to the parent orchestrator. It never writes or applies the shared transaction.
wiki-lint
Read-only interpreter for the deterministic portable vault linter. Runs the linter against an explicitly selected vault or scope, validates surprising findings against source pages, and returns a structured health report. It never writes reports or repairs the vault.
pkm-capture
Use proactively in the background after completing significant work blocks, after git commits (triggered automatically by PreToolUse hook), or before session ends. Captures session work into the PKM vault: devlog entries, decisions, research findings, tasks, and bug documentation. Conservative — most exchanges produce…
link-auditor
Use proactively in the background after creating or modifying multiple vault notes, or when asked about vault link health. Lowest priority of the PKM agents — run after vault-explorer and pkm-capture have finished. Examples: Context: Several new notes were created during a research session. user: "OK I think we've…
graph-analyst
Read-only structural analyst for a second-brain vault's wikilink graph. Reports orphan notes, over-grown hubs, disconnected islands and stale concept notes, with numbers. Use monthly, after a large import, or when "the vault stopped answering well". Never edits a note.
canvas-composer
Content strategist for canvas text nodes. Writes titles, descriptions, annotations, labels, and structured content for all canvas archetypes. Follows the 15-30 visible nodes per viewport principle. Content is scannable: headers, bullets, bold. Max 200 words per text node. Context: /canvas generate needs slide content…