Hermes agent

Obsidian

Чтение, поиск, создание и редактирование заметок в хранилище Obsidian.

Метаданные навыка

ИсточникВстроенный (установлен по умолчанию)
Путьskills/note-taking/obsidian
Платформыlinux, macos, windows

Справочник: полный SKILL.md

инфо

Ниже приведено полное определение навыка, которое Hermes загружает при его активации. Именно это агент видит как инструкции, пока навык активен.

Obsidian Vault

Используй этот навык для работы с хранилищем Obsidian через файловую систему как основной интерфейс: читать заметки, перечислять их, искать по файлам, создавать новые, дописывать содержимое и добавлять вики-ссылки.

Путь к хранилищу

Перед вызовом файловых инструментов убедись, что путь к хранилищу известен или разрешён.

Стандартный способ задать путь — переменная окружения OBSIDIAN_VAULT_PATH, например в файле ~/.hermes/.env. Если переменная не задана, используй ~/Documents/Obsidian Vault.

Файловые инструменты не раскрывают переменные оболочки. Не передавай в read_file, write_file, patch и search_files пути, содержащие $OBSIDIAN_VAULT_PATH — сначала разреши переменную и передавай конкретный абсолютный путь. Пути к хранилищу могут содержать пробелы — ещё одна причина предпочитать файловые инструменты командам оболочки.

Если путь неизвестен, terminal допустим для разрешения OBSIDIAN_VAULT_PATH или проверки существования запасного пути. Как только путь определён — переходи обратно на файловые инструменты.

Чтение заметки

Используй read_file с разрешённым абсолютным путём к заметке. Предпочтительнее cat: возвращает номера строк и поддерживает пагинацию.

Перечисление заметок

Используй search_files с target: "files" и разрешённым путём к хранилищу. Предпочтительнее find и ls.

  • Чтобы перечислить все markdown-заметки, передавай pattern: "*.md" по пути хранилища.
  • Для конкретной подпапки — ищи по её абсолютному пути.

Поиск

Для поиска по именам файлов и по содержимому используй search_files. Предпочтительнее grep, find и ls.

  • По именам файлов: search_files с target: "files" и pattern с нужным шаблоном имени.
  • По содержимому заметок: search_files с target: "content", регулярным выражением как pattern и file_glob: "*.md", если нужно ограничить поиск только markdown-файлами.

Создание заметки

Используй write_file с разрешённым абсолютным путём и полным markdown-содержимым. Предпочтительнее shell-heredoc’ов и echo — нет проблем с экранированием и результат возвращается структурированно.

Добавление в конец заметки

По возможности придерживайся нативного файлового инструментария, если это не порождает неуклюжего кода:

  • Прочитай целевую заметку через read_file.
  • Применяй patch для якорного дописывания, когда есть стабильный контекст: например, добавить раздел после существующего заголовка или дописать перед известным завершающим блоком.
  • Применяй write_file, когда переписать всю заметку понятнее, чем составлять хрупкий патч.

Для якорного дописывания через patch замени якорь на якорь плюс новое содержимое.

Для простого дописывания без стабильного контекста terminal допустим, если это самый чёткий и безопасный вариант.

Точечное редактирование

Для точечных изменений в заметке используй patch, когда текущее содержимое даёт стабильный контекст. Предпочтительнее текстового переписывания через оболочку.

Вики-ссылки

Obsidian связывает заметки синтаксисом [[Note Name]]. При создании заметок используй эти ссылки, чтобы связывать близкий по теме контент.

⌕ ESC