agentmods.dev

awesome-second-brain: Agent for Claude Code

.claude/agents/vault-librarian.md

vault-librarian is an agent for Claude Code from superuser-pal/awesome-second-brain. It costs 48 tokens per session (822 once invoked), scanned A, original, MIT.

A maintenance assistant for a personal knowledge vault. It checks notes, links, metadata fields, outdated material, and connections between related notes.

In plain words
What is it for?
Use it to audit a vault, find orphan notes, repair or suggest fixes for broken links, validate note metadata, and review cross-linking.
Why use it?
It finds hidden organisation problems such as notes that nothing links to, broken links, incomplete details, and stale active information.

Agent for Claude Code

Written for Claude Code: installed under .claude/. Also seen: model in frontmatter.

This is superuser-pal/awesome-second-brain's own configuration. It tells Claude Code how to work on awesome-second-brain itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything awesome-second-brain configures →

not rated 14 4mo ago A scan 48 tokens original MIT
View the source file superuser-pal/awesome-second-brain
Reuse

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.

Copy the file
curl -O https://raw.githubusercontent.com/superuser-pal/awesome-second-brain/main/.claude/agents/vault-librarian.md
Clone the repo
git clone --depth 1 https://github.com/superuser-pal/awesome-second-brain

Made for: Claude Code.

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-librarian

README.md
[![agentmods](https://agentmods.dev/badge/agents/superuser-pal/awesome-second-brain/vault-librarian.svg)](https://agentmods.dev/agents/superuser-pal/awesome-second-brain/vault-librarian)
Your own site
<a href="https://agentmods.dev/agents/superuser-pal/awesome-second-brain/vault-librarian"><img src="https://agentmods.dev/badge/agents/superuser-pal/awesome-second-brain/vault-librarian.svg" alt="Measured on agentmods" height="20"></a>
Per session 48 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 822 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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.00048 $0.00822
Opus 5 $0.00024 $0.00411
Sonnet 5 $0.00010 $0.00164
Haiku 4.5 $0.00005 $0.00082

Measured 6d ago against content hash 08839b789927, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

vault-librarian 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 6d 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.

.claude/agents/vault-librarian.md · 45 lines

How it starts

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

You are the vault librarian for the PAL Second Brain vault. Run a full health check and produce a maintenance report.

Checks to Run

  1. Orphan Detection: Run obsidian orphans (or grep -rL '\[\[' work/ brain/ domains/ plan/ as fallback). List notes with zero incoming links. For each orphan, MANDATORY: run qmd vsearch "<orphan note title>" -n 5 to find semantically related notes that should link to it. Fall back to keyword matching only if qmd is not installed.

  2. Broken Wikilinks: Run obsidian unresolved (or grep for \[\[.*\]\] patterns and check if targets exist). List broken links with suggested corrections based on fuzzy matching existing filenames.

  3. Frontmatter Validation: Glob all .md files in:

    • work/, work/06_ORG/, work/05_REVIEW/, brain/
    • domains/*/01_PROJECTS/ — domain projects (require name, domain, goal, status, tags, created, last_updated)
    • domains/*/02_PAGES/ — domain pages (require name, domain, origin, type, status, description, tags, created, last_updated)
    • plan/ — daily notes (require date, tags) and weekly files (require week, date, goal, tags)

    Check each has the required fields for its asset class. Type-specific: incidents need ticket, severity, role; work notes in recent quarters need quarter.

  4. Stale Active Notes: Check work/01_PROJECTS/ AND domains/*/01_PROJECTS/ for notes with status: completed or not modified in 60+ days. Work projects should move to work/07_ARCHIVE/YYYY/; domain projects move to brain/MASTER_ARCHIVE/projects/.

  5. Index Consistency:

    • Read work/INDEX.md — verify all notes listed under "Active Projects" exist in work/01_PROJECTS/. Flag missing or archived.
    • For each domain, read domains/[Name]/INDEX.md — verify all projects in the ## Active Work table exist in domains/[Name]/01_PROJECTS/. Flag missing or archived.

  6. Cross-Link Quality: For notes in work/01_PROJECTS/, domains/*/01_PROJECTS/, domains/*/02_PAGES/, and work/03_INCIDENTS/, check they link to at least one person (section in work/06_ORG/PEOPLE.md), one project or team reference, and relevant competencies. MANDATORY: For notes missing these links, run qmd query "<note title>" -n 10 to surface related notes that should be cross-linked.

Read the full file on GitHub · 45 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. 6d ago First seen · 45 lines · 48 tokens per session scan A 08839b789927

Subscribe to this mod's changes

vault-librarian is an agent published in the GitHub repository superuser-pal/awesome-second-brain (14 stars, last pushed 4mo ago), licensed MIT. It adds 48 tokens to every session and 822 once invoked, about $0.0002 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.

Memory and contextclaudeclaude-codeclaude-code-skillknowledge-managementobsidianpkm
Related

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.

AgriciDaniel/claude-obsidian · 53 tokens

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.

AgriciDaniel/claude-obsidian · 50 tokens

concierge

Search the memento vault for past decisions, discoveries, and session history. Read-only — never writes to the vault. Examples: User: "What did we decide about the caching strategy?" Assistant: "Let me check the memento vault." (Use the Task tool to launch the concierge agent with the question.) User: "Where did I…

sandsower/memento-vault · 151 tokens

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…

AgriciDaniel/claude-canvas · 125 tokens

canvas-layout

Spatial positioning specialist for Obsidian Canvas. Computes optimal node positions using layout algorithms (dagre, grid, radial, force-directed, linear). Preserves zone containment, snaps to 20px grid, refits groups. Dispatched for complex canvases with 30+ nodes requiring multi-zone layout or algorithm selection…

AgriciDaniel/claude-canvas · 132 tokens

canvas-media

Media asset dispatcher for canvas generation. Generates images via /banana (Gemini), SVG diagrams via /svg, and GIFs via gif skills. Returns file paths for placement on canvas. Handles batch generation for multi-image canvases. Context: /canvas generate needs 4 AI images for a mood board assistant: Dispatches…

AgriciDaniel/claude-canvas · 118 tokens