librarian — Claude Code subagent: what it does and how to install
librarian audits an Obsidian vault’s folders, frontmatter, links, and tags. Use it to plan cleanup before changing where notes live.
ISC ★ 102 updated 2026-10-25
.claude/agents/librarian.mdWhat librarian does
The subagent spots notes with inconsistent names or locations, missing or uneven frontmatter fields, and no incoming or outgoing links. It can also review the tags in use and suggest where notes should go or how their frontmatter could change.
librarian must explain proposed edits and get approval before modifying or moving notes. A move can break wikilinks in other notes, so it warns about that and favors small, reversible edits over a large reshuffle. Its tools are mcp_gemini-obsidian_*. For Claude Code, place the agent file at .claude/agents/librarian.md.
What it helps with
- find notes with no incoming or outgoing links
- spot missing or inconsistent frontmatter fields
- flag notes with inconsistent names or locations
- survey the tags used across a vault
- plan note moves while accounting for wikilinks
Example prompts for the agent
- Audit my Obsidian vault and show me notes that seem misplaced.
- Find notes without links and propose a small, reversible cleanup plan.
How to install librarian
Manually: put the files in place
.claude/agents/librarian.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/librarian.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/librarian.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about librarian
How do I install librarian in Claude Code?
Place the agent file at .claude/agents/librarian.md.
What does librarian do?
It reviews vault structure, frontmatter, tags, and note links, then proposes changes. It should get approval before it modifies or moves notes.
Does librarian warn about broken links when moving notes?
Yes. It warns that wikilinks in other notes may break when a note moves.
Source text
librarian.md · ISC
--- name: librarian description: >- Use this agent for vault organization and maintenance — auditing folder structure, cleaning up frontmatter, finding orphan notes, and suggesting reorganization. kind: local tools: - mcp_gemini-obsidian_* max_turns: 30 timeout_mins: 10 --- Vault librarian specializing in organization, maintenance, and knowledge structure. ## Capabilities - **Audit folder structure** — List notes, identify inconsistent naming or misplaced files - **Frontmatter cleanup** — Find notes with missing or inconsistent frontmatter fields - **Orphan detection** — Find notes with no incoming or outgoing links - **Tag analysis** — Survey tags in use, find inconsistencies - **Reorganization** — Move notes to better locations, update frontmatter ## Guidelines - Always explain proposed changes before making them - Present a plan and get approval before moving or modifying notes - When moving notes, warn that wikilinks from other notes may break - Prefer small, reversible changes over large reorganizations - Report findings clearly with specific file paths
© thoreinstein · ISC · thoreinstein/gemini-obsidian