Agent Skills › QuixiAI/Hexis › personal-notes

personal-notes

GitHub

用于在指定工作区路径下搜索、读取、创建和编辑 Markdown 格式的笔记（如 Obsidian 或 Bear 导出），确保操作安全并保留原有格式。

skills/installed/personal-notes/SKILL.md QuixiAI/Hexis

Trigger Scenarios

用户请求搜索个人笔记内容用户请求创建新的笔记文件用户请求修改或更新现有笔记

Install

npx skills add QuixiAI/Hexis --skill personal-notes -g -y

More Options

Non-standard path

npx skills add https://github.com/QuixiAI/Hexis/tree/main/skills/installed/personal-notes -g -y

Use without installing

npx skills use QuixiAI/Hexis@personal-notes

指定 Agent (Claude Code)

npx skills add QuixiAI/Hexis --skill personal-notes -a claude-code -g -y

安装 repo 全部 skill

npx skills add QuixiAI/Hexis --all -g -y

预览 repo 内 skill

npx skills add QuixiAI/Hexis --list

SKILL.md

Frontmatter

{
    "name": "personal-notes",
    "aliases": [
        "notes",
        "obsidian",
        "bear",
        "vault",
        "markdown",
        "notebook"
    ],
    "category": "knowledge",
    "contexts": [
        "chat"
    ],
    "requires": {
        "tools": [
            "read_file",
            "glob"
        ]
    },
    "bound_tools": [
        "glob",
        "grep",
        "list_directory",
        "read_file",
        "write_file",
        "edit_file",
        "fast_ingest",
        "recall",
        "remember"
    ],
    "description": "Search, read, create, and carefully edit Markdown notes in a user-mounted Obsidian vault or Bear export"
}

Personal Notes

Work with notes the user intentionally exposes inside the Hexis workspace. This supports Markdown-based Obsidian vaults and exported Bear notes; it does not reach into an unmounted home directory or Bear's private live database.

Establish the Note Root

Ask for the exact mounted vault or export path when it is not already explicit in the conversation or workspace configuration.
Confirm that the path is inside the permitted workspace. Never guess a path, scan the user's home directory, or reuse an unrelated repository because it happens to contain Markdown.
Use a narrow glob, list_directory, or grep under that root. Expand the search only when the initial results justify it.

Read and Search

Search titles, tags, links, and content, then read only the most relevant notes.
Cite note paths in the answer so the user can locate the source.
Preserve the distinction between text in a note, a Hexis memory, and the assistant's inference.
Do not ingest an entire vault into memory by default. Use fast_ingest only for files the user explicitly chooses and explain that it creates derived memories.

Create and Edit

Resolve the exact target path and inspect any existing file before proposing a change.
Preserve YAML frontmatter, tags, wiki links, embeds, heading style, and surrounding formatting.
Prefer a targeted edit_file operation for an existing note. For a new note, show the proposed path and content before write_file unless the user's request already specified both.
Never overwrite a note to append a small section, never silently rename or move notes, and never resolve link conflicts by deleting content.
After a write, state the path and what changed. If the tool reports a failure, do not claim the note was saved.

No Dead Ends

If the vault is not mounted, tell the user to mount or copy it into the Hexis workspace and provide that path.
For Bear, request a Markdown export or mounted export directory; do not advise modifying Bear's internal database.
If writes are disallowed, provide the ready-to-paste Markdown and exact intended path so the work remains useful.