Obsidian Skills — официальный набор Agent Skills: научите Claude Code, Codex и OpenCode работать с Obsidian

Obsidian Skills — набор официальных Agent Skills для Obsidian от kepano. Скиллы следуют спецификации Agent Skills, поэтому работают с любым skills-совместимым агентом: Claude Code, Codex, OpenCode и другими. После установки агент умеет создавать и редактировать заметки в диалекте Obsidian, строить базы данных из заметок, рисовать canvas-схемы и управлять запущенным приложением Obsidian через CLI.

Набор закрывает весь стек форматов Obsidian: от обычного Markdown с вики-ссылками до декларативных баз и JSON Canvas. Проект на GitHub собрал 48.2k звёзд, распространяется под лицензией MIT.

Что внутри: шесть скиллов

Установка

Есть три способа — через маркетплейс Claude Code, через утилиту npx skills или вручную.

Маркетплейс Claude Code

/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills

npx skills

npx skills add git@github.com:kepano/obsidian-skills.git

Если предпочитаете https вместо ssh:

npx skills add https://github.com/kepano/obsidian-skills

Вручную

Claude Code. Скопируйте содержимое репозитория в папку /.claude в корне хранилища Obsidian (или в ту папку, с которой работаете через Claude Code).

Codex. Скопируйте каталог skills/ в путь скиллов Codex (обычно ~/.codex/skills). Формат скилла соответствует спецификации Agent Skills.

OpenCode. Склонируйте весь репозиторий в каталог скиллов:

git clone https://github.com/kepano/obsidian-skills.git ~/.opencode/skills/obsidian-skills

Важный нюанс: не копируйте только внутреннюю папку skills/ — нужен весь репозиторий, чтобы структура была ~/.opencode/skills/obsidian-skills/skills/<skill-name>/SKILL.md. OpenCode автоматически находит все SKILL.md под ~/.opencode/skills/, менять opencode.json или другие конфиги не нужно. Скиллы станут доступны после перезапуска OpenCode.

obsidian-markdown: диалект Obsidian под контролем агента

Obsidian расширяет CommonMark и GFM собственным синтаксисом, и именно на нём чаще всего ломаются агенты, привыкшие к обычному Markdown. Скилл описывает workflow создания заметки: сначала frontmatter со свойствами, затем контент, потом связи через wikilinks, встраивания через ![[embed]] и callouts для выделенной информации.

Ключевые конструкции, которые агент учится применять:

[[Note Name]]                  Link to note
[[Note Name|Display Text]]     Custom display text
[[Note Name#Heading]]          Link to heading

![[Note Name]]                 Embed full note
![[image.png|300]]             Embed image with width
![[document.pdf#page=3]]       Embed PDF page

> [!warning] Custom Title
> Callout with a custom title.

==Highlighted text==           Highlight syntax

This is visible %%but this is hidden%% text.

Скилл фиксирует и правило выбора между типами ссылок: [[wikilinks]] — для заметок внутри хранилища (Obsidian автоматически отслеживает переименования), [text](url) — только для внешних URL. Также разобраны свойства frontmatter (tags, aliases, cssclasses), вложенные теги вида #nested/tag, сноски, LaTeX-математика и Mermaid-диаграммы с привязкой узлов к заметкам через class NodeName internal-link;.

obsidian-bases: базы данных из заметок

Bases — формат Obsidian для создания представлений заметок в духе баз данных. Скилл учит агента писать валидные .base-файлы на YAML: определять глобальные фильтры, вычисляемые свойства-формулы и представления четырёх типов — table, cards, list и map.

filters:
  and:
    - 'status == "active"'
    - not:
        - 'file.hasTag("archived")'

formulas:
  days_until_due: 'if(due, (date(due) - today()).days, "")'

views:
  - type: table
    name: "Active Tasks"
    order:
      - file.name
      - status
      - formula.days_until_due
    groupBy:
      property: status
      direction: ASC

Отдельно скилл разбирает типичные ошибки агентов: кавычки в YAML-формулах (формулы с двойными кавычками оборачиваются в одинарные), работа с типом Duration — разность дат не число, и перед .round() нужно обратиться к полю .days, защита от отсутствующих свойств через if(). Включены готовые примеры: трекер задач, список для чтения с карточками и индекс ежедневных заметок.

obsidian-cli: управление запущенным Obsidian

Скилл obsidian-cli учит агента работать с CLI-утилитой obsidian, которая взаимодействует с запущенным экземпляром приложения (Obsidian должен быть открыт). Синтаксис: параметры передаются через =, флаги — булевы переключатели без значения.

obsidian read file="My Note"
obsidian create name="New Note" content="# Hello" template="Template" silent
obsidian append file="My Note" content="New line"
obsidian search query="search term" limit=10
obsidian daily:append content="- [ ] New task"
obsidian property:set name="status" value="done" file="My Note"
obsidian tasks daily todo
obsidian tags sort=count counts
obsidian backlinks file="My Note"

Есть два режима адресации: file=<name> резолвится как wikilink (только имя, без пути и расширения), path=<path> — точный путь от корня хранилища. По умолчанию команды таргетируют последний сфокусированный vault, а параметр vault="My Vault" позволяет выбрать конкретный.

Самая интересная часть — цикл разработки плагинов и тем:

obsidian plugin:reload id=my-plugin
obsidian dev:errors
obsidian dev:screenshot path=screenshot.png
obsidian dev:dom selector=".workspace-leaf" text
obsidian dev:console level=error
obsidian eval code="app.vault.getFiles().length"

Агент меняет код плагина, перезагружает его, проверяет ошибки, делает скриншот или инспектирует DOM, смотрит консоль — полный loop тестирования без ручных действий. Дополнительно доступны dev:css для инспекции CSS-значений и dev:mobile для эмуляции мобильного режима.

json-canvas, defuddle и knap

json-canvas — скилл для файлов .canvas: узлы, рёбра, группы и связи в открытом формате JSON Canvas. Полезен, когда нужно, чтобы агент строил визуальные схемы и карты из заметок.

defuddle — обёртка над библиотекой Defuddle того же автора: агент вытаскивает из веб-страниц чистый Markdown без навигации, рекламы и прочего мусора. Практичная экономия токенов при сохранении статей в хранилище.

knap — рендеринг Markdown-шаблонов из данных в JSON или CSV через инструмент Knap, включая пакетную генерацию файлов: например, когда нужно создать десятки однотипных заметок из таблицы.

Кому пригодится

Набор особенно ценен, если вы ведёте хранилище Obsidian и хотите делегировать агенту рутину: создание структурированных заметок, наведение порядка в связях, построение представлений Bases, пакетную генерацию из данных. А скилл obsidian-cli превращает агента в полноценного помощника по разработке плагинов Obsidian — с перезагрузкой, скриншотами и инспекцией DOM прямо из цикла агентной разработки.

Поскольку скиллы соответствуют открытой спецификации Agent Skills, тот же набор работает и за пределами Claude Code — формат совместим с Codex, OpenCode и любым другим агентом, поддерживающим спецификацию.