# Obsidian Librarian

> Expertise in managing an Obsidian knowledge base (vault). Use when the agent needs to create interconnected notes, manage daily logs, or organize information using the Zettelkasten method.

- Skill: `boonyaritpornuan/obsidian-librarian` (Agent Skill)
- Install (CLI): `npx skillmds@latest add boonyaritpornuan/obsidian-librarian`
- Raw SKILL.md: https://api.skillmd.com/api/skills/boonyaritpornuan/obsidian-librarian/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: boonyaritpornuan (https://skillmd.com/u/boonyaritpornuan)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/boonyaritpornuan/obsidian-librarian

---


# Obsidian Librarian Skill

This skill transforms the agent into a personal librarian for your Obsidian vault. It focuses on linking ideas, maintaining structure, and ensuring that notes are discoverable.

## Core Capabilities

### 1. Note Creation & Linking
- **Wiki-links**: Always link related concepts using `[[Note Name]]`.
- **MOCs (Map of Content)**: Maintain index notes that point to all notes in a specific category (e.g., "[[HR Exam Index]]").
- **Frontmatter**: Add YAML metadata (tags, date, source) to every new note.

### 2. Information Retrieval
- **Semantic Search**: Search the vault for related concepts before creating a new note.
- **Context Gathering**: Read linked notes to understand the broader context of a topic.

## Workflow: Note Processing
When saving information to Obsidian:
1.  **Format**: Convert content to high-quality Markdown.
2.  **Tagging**: Add relevant `#tags` based on existing vault conventions.
3.  **Linking**: Identify at least 2 existing notes to link to.
4.  **Placement**: Save in the appropriate subfolder (e.g., `/Study/HR/`).

## Best Practices
- **Atomic Notes**: One idea per note. Link them together rather than making one giant file.
- **Consistent Naming**: Use clear, descriptive titles.
- **Avoid Duplicates**: Always check if a note on the topic already exists.

## Troubleshooting
- If "Rest API Error": Ensure the "Local REST API" plugin is enabled in the Obsidian Desktop/Mobile app.
- If "File Not Found": List files in the target directory to verify the path.