Obsidian Agent Skills — это основное ключевое слово для данного руководства по общедоступному репозиторию GitHub kepano/obsidian-skills. Данный репозиторий появился в снимке GitHub Daily Trending от 2026-08-14. Эта дата — контекст, а не утверждение о постоянной популярности. В этом руководстве основное внимание уделяется тому, что можно проверить и протестировать до того, как навык начнёт работать с хранилищем Obsidian.
Содержимое репозитория
В README эти файлы описаны как навыки агента для Obsidian. Они соответствуют спецификации Agent Skills и предназначены для агентов, совместимых с навыками, включая Claude Code, Codex и OpenCode. Репозиторий обучает агента использовать Obsidian CLI и открытые форматы, а не скрывать рабочие процессы внутри проприетарной базы данных.
В текущем дереве находятся пять каталогов навыков:
obsidian-markdownохватывает Obsidian Flavored Markdown, включая вики-ссылки, встраиваемые элементы, выноски, свойства, теги, комментарии и математические формулы.obsidian-basesобъясняет файлы.base, записанные в YAML, с фильтрами, формулами, свойствами, представлениями и сводками.json-canvasследует за JSON Canvas 1.0 с узлами, рёбрами, группами и проверками валидации.obsidian-cliдокументирует команды для чтения, создания, поиска и обновления заметок и свойств, а также команды для разработки плагинов.defuddleописывает CLI, извлекающий чистый Markdown из веб-страниц. В описании навыка говорится, что пакетdefuddleможно установить глобально с помощью npm, если он недоступен.
Манифест маркетплейса содержит один плагин с именем obsidian, версии 1.0.1. В манифесте плагина указано, что пакет лицензирован по MIT и предназначен для файлов Markdown, Bases и Canvas. Корневой каталог LICENSE также распространяется по лицензии MIT. Перед повторным распространением изменённой копии проверьте точный каталог навыка и все включённые зависимости.
Выберите способ установки
В README описаны три варианта. Используйте тот, который соответствует хосту вашего агента, затем зафиксируйте проверенную вами ревизию.
Для установки из маркетплейса Claude Code:
/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skillsДля процесса npx skills в README приведены варианты и для SSH, и для HTTPS:
npx skills add git@github.com:kepano/obsidian-skills.git
npx skills add https://github.com/kepano/obsidian-skillsРучные схемы размещения различаются. Claude Code может использовать содержимое репозитория в папке /.claude в корне хранилища. Codex обычно считывает каталог skills/ из пути к своим навыкам. OpenCode должен клонировать весь репозиторий в ~/.opencode/skills/obsidian-skills, поскольку при его обнаружении ожидается, что skills/<skill-name>/SKILL.md будет находиться в этом каталоге. В файле README указано, что после клонирования необходимо перезапустить OpenCode, и содержится предупреждение о недопустимости копирования только внутренней папки skills/.
Перед выполнением команды запишите, какой коммит вы проверили. На момент снимка main указывал на a1dc48e68138490d522c04cbf5822214c6eb1202. API релизов GitHub не вернул ни одного релиза, поэтому для практической проверки воспроизводимости в этом руководстве используется закрепление коммита.
Используйте Obsidian CLI при открытии файлов.
Навык obsidian-cli в репозитории сообщает, что команда obsidian взаимодействует с запущенным экземпляром Obsidian. Он использует параметры key=value и булевы флаги. В навыке приведены такие примеры, как:
obsidian vault="My Vault" search query="project" limit=10
obsidian read file="Daily note"
obsidian create name="New Note" content="# Hello" silent
obsidian property:set name="status" value="done" file="Daily note"Используйте path=, когда требуется точный путь относительно корня хранилища. Используйте vault=, когда доступно более одного хранилища. Начните с операций чтения и поиска на одноразовой копии. Добавляйте команды записи только после того, как узнаете, какие файлы изменятся. В навыке отмечается, что CLI требует открытого Obsidian, поэтому не следует предполагать, что он будет работать на сервере без графического интерфейса.
Другие навыки явно описывают форматы файлов. В заметках Markdown можно использовать вики-ссылки, такие как [[Project]], встраивания, такие как ![[image.png]], выноски, свойства, теги, комментарии и математические выражения. Bases — это YAML-документы с фильтрами и представлениями. Файлы Canvas представляют собой JSON с nodes и edges, а навык включает проверки уникальности идентификаторов и корректности ссылок на рёбра. Эти инструкции помогают агенту редактировать текст и структурированные файлы, но не заменяют собственную проверку Obsidian.
Проверьте сторонний навык перед его включением
Рассматривайте навык как исполняемую конфигурацию. Прочитайте его SKILL.md frontmatter и каждый указанный файл, который будет загружен хостом. Поищите во включённых скриптах команды оболочки, сетевые запросы, распаковку архивов, запись файлов и доступ к переменным окружения. Проверьте лицензию в папке, которую вы будете использовать, а не только лицензию в корневом каталоге.
Выполните первую задачу в отдельном временном хранилище с минимально необходимыми разрешениями и без рабочих секретов. Сохраните проверенный коммит доступным для отката. При обновлении сравните diff перед заменой зафиксированной копии. Если навык вызывает внешний инструмент или модель, проверьте настройки аутентификации и хранения данных этого инструмента.
В репозитории отсутствует корневой SECURITY.md, а список релизов пуст в зафиксированном снимке. Это не доказывает, что код небезопасен. Это означает, что вам следует вести собственные заметки о проверке и не считать страницу GitHub сертификатом безопасности.
Конфиденциальность локальных данных и практические ограничения
Хранилище Obsidian представляет собой набор локальных файлов, но локальное хранение не гарантирует локальную обработку. Агент может считывать файлы и передавать выбранный текст модели, пакету командной строки, серверу MCP или другой сетевой службе. Перед запуском определите, какие папки входят в область действия, удалите секреты из тестового хранилища и проверьте журналы и настройки поставщика на наличие исходящих данных. Не предоставляйте новому навыку доступ ко всему домашнему каталогу, если ему нужно только одно хранилище.
Совместимость является условной. Репозиторий не публикует универсальную матрицу клиентов, требования к оборудованию, результаты тестов производительности, цены или список поддерживаемых моделей. Команда, задокументированная для Claude Code, автоматически не становится допустимой для Codex или OpenCode. Протестируйте минимальную полезную задачу с использованием именно того клиента и версии Obsidian, которые вы планируете применять.
Где подходит OdiRouter
kepano/obsidian-skills — это сторонний репозиторий с открытым исходным кодом, а не продукт OdiRouter. Источники не указывают на наличие аффилированности, а OdiRouter не устанавливает и не проверяет эти навыки.
OdiRouter может выступать отдельным уровнем маршрутизации API, когда приложению требуется направлять запросы к разным маршрутам моделей ИИ. На текущем сайте описаны API моделей и среда выполнения агента. В официальной документации есть введение с API-ключами и идентификаторами моделей, интеграция Claude Code через API, совместимый с Anthropic, а также настройка SDK OpenAI:
Эти маршруты не меняют разрешения, лицензию или правила обработки конфиденциальности репозитория. Проверьте текущий маршрут модели и условия обработки данных перед подключением рабочего процесса к реальному хранилищу.
Краткий контрольный список перед запуском
Зафиксируйте
a1dc48e68138490d522c04cbf5822214c6eb1202или редакцию, которую вы фактически проверяете.Выберите один способ установки для своего клиента и сохраните предыдущую копию для отката.
Прочитайте
SKILL.md, ссылки, скрипты, лицензии и манифесты зависимостей выбранного навыка.Протестируйте команды только для чтения в отдельном временном хранилище, прежде чем разрешать запись.
Предоставьте только те хранилище и инструменты, которые нужны для выполнения задачи.
Проверьте, какой текст может покинуть хранилище и где он регистрируется.
При каждом обновлении повторно проверяйте различия и разрешения.