add-obsidian

Mount a local Obsidian vault as a read-only knowledge base for Nanobot.

1|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/mk-knight23/AI-Agent-Nanobot --skill add-obsidian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-obsidian
Source: https://github.com/mk-knight23/AI-Agent-Nanobot/tree/main/skills/add-obsidian
Command: npx skills add https://github.com/mk-knight23/AI-Agent-Nanobot --skill add-obsidian

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Mounts an Obsidian vault as a read-only knowledge base for Nanobot, enabling context-aware reasoning by referencing your notes without risking modification.

Core Features & Use Cases

  • Read-only vault access: Nanobot can search your Obsidian notes to surface relevant context during tasks.
  • Async full-text search with density scoring: Returns high-quality excerpts to inform answers.
  • Safe integration: Keeps your vault immutable and local, using a dedicated vault_search tool for on-demand queries.

Quick Start

Mount your Obsidian vault and use the vault_search tool to retrieve relevant notes for a question.

Frequently Asked Questions about add-obsidian

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search an Obsidian vault to provide context for AI tasks?

You can search an Obsidian vault by mounting it as a read-only knowledge base. This registers a vault_search tool that asynchronously queries your local notes with full-text scoring to surface relevant excerpts for AI context.

Can I safely let an AI agent read my Obsidian notes without modifying them?

Yes, you can safely allow an AI agent to read your Obsidian notes by mounting the vault in read-only mode. This keeps your local files immutable while the agent retrieves contextual information on demand.

How does asynchronous full-text search work on a local knowledge base?

Asynchronous full-text search on a local knowledge base works by scanning vault notes and applying density scoring to evaluate relevance. It returns high-quality excerpts from your files to inform AI responses without blocking workflows.

Do I need a specific directory structure to mount an Obsidian vault as a knowledge base?

You need a local Obsidian vault directory to mount it as a knowledge base. The Skill requires this local path to register the vault_search tool and enable on-demand asynchronous queries against your notes.

What are the limitations of using a read-only vault for AI context retrieval?

The limitation of using a read-only vault is that the AI cannot create, edit, or delete notes. It is strictly for referencing existing knowledge to provide context, meaning any required note updates must be done manually outside the workflow.

What is the best way to surface relevant excerpts from personal notes for AI reasoning?

The best way to surface relevant excerpts is using an asynchronous full-text search with density scoring on a mounted local vault. This approach evaluates text relevance and returns high-quality context segments to inform AI answers.