personal-notes

Search, read, create, and edit Markdown notes in mounted Obsidian vaults or Bear exports.

609|81|Updated Nov 15, 2024
One-click install
npx skills add https://github.com/QuixiAI/Hexis --skill personal-notes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: personal-notes
Source: https://github.com/QuixiAI/Hexis/tree/main/skills/installed/personal-notes
Command: npx skills add https://github.com/QuixiAI/Hexis --skill personal-notes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Working with personal Markdown notes requires careful handling of vault structure, frontmatter, and wiki links, and mistakes like overwriting files or scanning the wrong directory can destroy note content. This Skill provides a disciplined workflow for searching, reading, creating, and editing notes inside a user-mounted Obsidian vault or Bear export without touching unmounted directories or private databases.

Core Features & Use Cases

  • Scoped Search and Reading: Search titles, tags, links, and content within an explicitly confirmed note root, then read only the most relevant notes and cite their paths.
  • Safe Creation and Editing: Preserve YAML frontmatter, tags, wiki links, embeds, and formatting while making targeted edits, and confirm paths and content before writing new notes.
  • Clear Boundaries: Never scan the home directory, ingest entire vaults into memory by default, or modify Bear's internal database; provide ready-to-paste Markdown when writes are disallowed.
  • Use Case: Mount your Obsidian vault into the workspace, then ask the assistant to find all notes tagged with a project name and append a meeting summary to the correct note without breaking existing links.

Quick Start

Mount your Obsidian vault into the workspace and ask the assistant to search the vault for notes about a specific topic and summarize what it finds with note paths.

Frequently Asked Questions about personal-notes

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

FAQPage Schema
How do I search my Obsidian vault with an AI assistant?

Mount the vault into the workspace and provide its exact path. The assistant then uses glob, grep, and list_directory scoped to that root to search titles, tags, links, and content, reading only the most relevant notes and citing their paths.

Can the assistant edit Obsidian notes without breaking links?

Yes. It inspects the existing file first, preserves YAML frontmatter, tags, wiki links, embeds, and heading style, and uses targeted edits rather than full overwrites. It never silently renames or moves notes.

Does this work with Bear notes?

It works with Bear notes only through a Markdown export or a mounted export directory. It does not access or modify Bear's private live database, so you must export your notes first.

Will my whole vault be ingested into memory?

No. Vault-wide ingestion is disabled by default. The fast_ingest tool is used only for files you explicitly choose, and the assistant explains that it creates derived memories before doing so.

What happens if the vault is not mounted or writes are blocked?

The assistant tells you to mount or copy the vault into the workspace and provide the path. If writes are disallowed, it delivers ready-to-paste Markdown with the exact intended path so the work remains usable.