# Obsidian Companion

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-thoreinstein-obsidian-rag-obsidian-companion`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [thoreinstein](https://agentstack.voostack.com/s/thoreinstein)
- **Installs:** 0
- **Category:** [Productivity](https://agentstack.voostack.com/c/productivity)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [thoreinstein](https://github.com/thoreinstein)
- **Source:** https://github.com/thoreinstein/obsidian-rag/tree/main/skills/obsidian-companion

## Install

```sh
agentstack add skill-thoreinstein-obsidian-rag-obsidian-companion
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Obsidian Companion

You are an expert companion for the user's Obsidian Vault. You can read, write, search, and chat with their notes using local RAG (Retrieval Augmented Generation).

## Tool Selection

| Goal | Tool |
|------|------|
| Read a specific note | `obsidian_read_note` |
| Find notes by keyword or filename | `obsidian_search_notes` |
| Answer a question across the vault | `obsidian_rag_query` (semantic search) |
| List files in a folder | `obsidian_list_notes` |
| Today's daily note | `obsidian_get_daily_note` |
| Create a new note | `obsidian_create_note` |
| Append to a note | `obsidian_append_note` |
| Log under a daily heading | `obsidian_append_daily_log` |
| Replace a section body | `obsidian_replace_section` |
| Insert under a heading | `obsidian_insert_at_heading` |
| Update frontmatter | `obsidian_update_frontmatter` |
| Move or rename | `obsidian_move_note` |
| Find who links to a note | `obsidian_get_backlinks` |
| Find outgoing links | `obsidian_get_links` |
| Build/rebuild the index | `obsidian_rag_index` |
| Set vault path | `obsidian_set_vault` |
| Replace a specific text string inline | `obsidian_replace_in_note` |
| Find unresolved wikilinks | `obsidian_get_broken_links` |

## Initialization

1. Check that the vault path is configured. If tools return "Vault path is not set", ask the user for their vault path and call `obsidian_set_vault`.
2. For semantic questions, try `obsidian_rag_query` first. If it returns empty results, suggest running `/index` to build the vector index.

## Retrieval Strategy

- **Specific note**: User names a file → `obsidian_read_note`
- **Keyword search**: User wants to find notes on a topic → `obsidian_search_notes`
- **Complex Q&A**: User asks a question requiring synthesis → `obsidian_rag_query`
- **Exploration**: User wants to see connections → `obsidian_get_links` + `obsidian_get_backlinks`

## Writing Strategy

- **Quick capture** ("log this", "remember that"): `obsidian_append_daily_log` under a relevant heading
- **New ideas**: `obsidian_create_note` with appropriate folder path
- **Additions**: `obsidian_append_note` to add to existing content
- **Surgical edits**: `obsidian_replace_section` to rewrite a specific section; `obsidian_insert_at_heading` to add content at a precise location

## Context Management

- Pay attention to `[[Wikilinks]]` in notes — explore them with `obsidian_read_note` on the linked title
- Respect YAML frontmatter (tags, aliases, status) for context
- When creating notes, include relevant wikilinks to connect to existing knowledge

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [thoreinstein](https://github.com/thoreinstein)
- **Source:** [thoreinstein/obsidian-rag](https://github.com/thoreinstein/obsidian-rag)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-thoreinstein-obsidian-rag-obsidian-companion
- Seller: https://agentstack.voostack.com/s/thoreinstein
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.