К основному содержанию
скилл CX Codex

obsidian-nvim — скилл для Claude Code: что делает и как установить

Помогает настроить плагин obsidian.nvim в Neovim: подключить хранилища Obsidian, ежедневные заметки, поиск через ripgrep и автодополнение.

MIT 116 установок ★ 17 обновлён 2026-10-14

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add julianobarbosa/claude-code-skills --skill obsidian-nvim -a claude-code
Открыть на GitHub

Что делает obsidian-nvim

Скилл снабжает ИИ-агента инструкциями по установке и настройке плагина obsidian.nvim. Он описывает конфигурацию воркспейсов, шаблонов, генерацию Zettelkasten-идентификаторов для заметок и связку с поисковыми пикерами Telescope, fzf-lua или mini.pick.

Внутри собраны схемы автодополнения для nvim-cmp и blink.cmp, правила работы с метаданными во frontmatter и сочетания клавиш для перехода по ссылкам Markdown. Без утилиты ripgrep в системе автодополнение заметок и поиск работать не будут.

Для вставки картинок на macOS потребуется pngpaste, а в Linux — xclip или wl-clipboard. Форматы дат в плагине задаются через синтаксис Lua os.date вроде %Y-%m-%d, а не привычными шаблонами самого Obsidian.

Какие задачи решает

  • Настроить плагин obsidian.nvim через менеджер lazy.nvim
  • Подключить автодополнение вики-ссылок через nvim-cmp или blink.cmp
  • Задать шаблоны ежедневных заметок и генерацию Zettelkasten ID
  • Интегрировать поиск заметок с Telescope или fzf-lua

Примеры запросов агенту

  • Помоги настроить obsidian.nvim в lazy.nvim с двумя хранилищами personal и work
  • Настрой автодополнение вики-ссылок через blink.cmp для obsidian.nvim
  • Как исправить ошибку, если в Neovim не работает поиск заметок Obsidian?

Как установить obsidian-nvim

1Через Skills CLI (Vercel)

npx skills add julianobarbosa/claude-code-skills --skill obsidian-nvim -a claude-code

2Вручную: положить файлы

~/.claude/skills/obsidian-nvim/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/obsidian-nvim/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об obsidian-nvim

Как установить obsidian-nvim в Claude Code?

Выполните команду npx skills add julianobarbosa/claude-code-skills --skill obsidian-nvim -a claude-code.

Что делает скилл obsidian-nvim?

Он даёт агенту готовые примеры Lua-конфигураций, команд и горячих клавиш для плагина obsidian.nvim в Neovim.

Какие системные требования нужны для работы плагина?

Требуется Neovim версии 0.10.0 или новее и утилита ripgrep. Для вставки картинок из буфера обмена нужен pngpaste на macOS или xclip либо wl-clipboard в Linux.

Исходный текст

SKILL.md · MIT
---
name: obsidian-nvim
description: Guide for implementing obsidian.nvim - a Neovim plugin for Obsidian vault management. Use when configuring, troubleshooting, or extending obsidian.nvim features including workspace setup, daily notes, templates, completion, pickers, and UI customization.
---

# obsidian.nvim Skill

A comprehensive guide for implementing and configuring obsidian.nvim - the Neovim plugin for managing Obsidian vaults.

## Quick Start

### Minimal Installation (lazy.nvim)

```lua
return {
  "obsidian-nvim/obsidian.nvim",
  version = "*",
  ft = "markdown",
  opts = {
    workspaces = {
      { name = "personal", path = "~/vaults/personal" },
    },
  },
}
```

### System Requirements

- **Neovim**: >= 0.10.0
- **ripgrep**: Required for completion and search (`brew install ripgrep`)
- **pngpaste** (macOS): For image pasting (`brew install pngpaste`)
- **xclip/wl-clipboard** (Linux): For image pasting

## Configuration

See [references/configuration.md](references/configuration.md) for complete configuration options.

### Essential Configuration Options

```lua
require("obsidian").setup({
  -- Workspace configuration (required)
  workspaces = {
    { name = "personal", path = "~/vaults/personal" },
    { name = "work", path = "~/vaults/work" },
  },

  -- Daily notes
  daily_notes = {
    folder = "daily",
    date_format = "%Y-%m-%d",
    alias_format = "%B %-d, %Y",
    default_tags = { "daily-notes" },
  },

  -- Templates
  templates = {
    folder = "templates",
    date_format = "%Y-%m-%d",
    time_format = "%H:%M",
  },

  -- Note ID generation (Zettelkasten-style by default)
  note_id_func = function(title)
    local suffix = ""
    if title ~= nil then
      suffix = title:gsub(" ", "-"):gsub("[^A-Za-z0-9-]", ""):lower()
    else
      for _ = 1, 4 do
        suffix = suffix .. string.char(math.random(65, 90))
      end
    end
    return tostring(os.time()) .. "-" .. suffix
  end,

  -- Completion settings
  completion = {
    nvim_cmp = true,  -- or blink = true for blink.cmp
    min_chars = 2,
  },

  -- UI customization
  ui = {
    enable = true,
    checkboxes = {
      [" "] = { char = "󰄱", hl_group = "ObsidianTodo" },
      ["x"] = { char = "", hl_group = "ObsidianDone" },
    },
  },
})
```

## Commands

See [references/commands.md](references/commands.md) for complete command reference.

### Primary Commands

| Command | Description |
|---------|-------------|
| `:Obsidian` | Open command picker |
| `:Obsidian today [OFFSET]` | Open/create daily note |
| `:Obsidian new [TITLE]` | Create new note |
| `:Obsidian search [QUERY]` | Search vault with ripgrep |
| `:Obsidian quick_switch` | Fuzzy find notes |
| `:Obsidian backlinks` | Show references to current note |
| `:Obsidian template [NAME]` | Insert template |
| `:Obsidian workspace [NAME]` | Switch workspace |

### Visual Mode Commands

| Command | Description |
|---------|-------------|
| `:Obsidian link [QUERY]` | Link selection to existing note |
| `:Obsidian link_new [TITLE]` | Create note and link selection |
| `:Obsidian extract_note [TITLE]` | Extract selection to new note |

## Keymaps

### Smart Action (Recommended: `<CR>`)

```lua
vim.keymap.set("n", "<CR>", function()
  if require("obsidian").util.cursor_on_markdown_link() then
    return "<cmd>Obsidian follow_link<CR>"
  else
    return "<CR>"
  end
end, { expr = true })
```

### Navigation Links

```lua
vim.keymap.set("n", "[o", function()
  require("obsidian").util.nav_link("prev")
end, { buffer = true, desc = "Previous link" })

vim.keymap.set("n", "]o", function()
  require("obsidian").util.nav_link("next")
end, { buffer = true, desc = "Next link" })
```

## Picker Integration

Configure your preferred picker:

```lua
picker = {
  name = "telescope",  -- or "fzf-lua", "mini.pick", "snacks.picker"
  note_mappings = {
    new = "<C-x>",
    insert_link = "<C-l>",
  },
  tag_mappings = {
    tag_note = "<C-x>",
    insert_tag = "<C-l>",
  },
},
```

## Completion Integration

### With blink.cmp

```lua
completion = {
  blink = true,
  nvim_cmp = false,
  min_chars = 2,
},
```

### With nvim-cmp

```lua
completion = {
  nvim_cmp = true,
  blink = false,
  min_chars = 2,
},
```

**Triggers:**
- `[[` - Wiki link completion
- `[` - Markdown link completion
- `#` - Tag completion

## Templates

### Template Variables

| Variable | Description |
|----------|-------------|
| `{{title}}` | Note title |
| `{{date}}` | Current date |
| `{{time}}` | Current time |
| `{{id}}` | Note ID |

### Custom Substitutions

```lua
templates = {
  folder = "templates",
  substitutions = {
    yesterday = function()
      return os.date("%Y-%m-%d", os.time() - 86400)
    end,
    tomorrow = function()
      return os.date("%Y-%m-%d", os.time() + 86400)
    end,
  },
},
```

## Frontmatter Management

```lua
frontmatter = {
  enabled = true,
  func = function(note)
    local out = { id = note.id, aliases = note.aliases, tags = note.tags }
    if note.metadata ~= nil and not vim.tbl_isempty(note.metadata) then
      for k, v in pairs(note.metadata) do
        out[k] = v
      end
    end
    return out
  end,
  sort = { "id", "aliases", "tags" },
},
```

## Troubleshooting

See [references/troubleshooting.md](references/troubleshooting.md) for comprehensive troubleshooting.

### Health Check

```vim
:checkhealth obsidian
```

### Quick Fixes

| Issue | Solution |
|-------|----------|
| Completion not working | Install ripgrep: `brew install ripgrep` |
| Picker not opening | Verify picker name matches installed plugin |
| Images not pasting | macOS: `brew install pngpaste` |
| Links not following | Ensure cursor is on `[[link]]` or `[text](link)` |
| Checkboxes not rendering | Set `:set conceallevel=2` |
| Workspace not found | Verify path exists and file is inside vault |

### Debug Mode

```lua
log_level = vim.log.levels.DEBUG,
```

## Examples

See [references/examples.md](references/examples.md) for practical configuration examples.

## Resources

- [GitHub Repository](https://github.com/obsidian-nvim/obsidian.nvim)
- [Wiki Documentation](https://github.com/obsidian-nvim/obsidian.nvim/wiki)
- [Breaking Changes](https://github.com/obsidian-nvim/obsidian.nvim/wiki/Breaking-Changes)

---

## Gotchas

- **The plugin requires Obsidian to be running for live updates** — vault changes from Neovim don't propagate to Obsidian's index until the app is open AND has focused the vault.
- **Completion source ordering conflicts with `cmp-buffer`** — LSP completion may not show note suggestions if buffer source ranks higher; explicit `sorting.priority_weight` adjustment needed.
- **Daily-note template paths use Lua's `os.date` format**, not Obsidian's natural-language date format — `%Y-%m-%d` in nvim, `YYYY-MM-DD` in Obsidian.
- **`require("obsidian").get_client():resolve_link()` returns nil for an unindexed file** — even if the file exists. Force a `:ObsidianRefresh` after creating notes outside the plugin.
- **lazy.nvim lazy-loading on `BufRead`: the first vault file you open before plugin spec evaluation doesn't get note features** — set `lazy=false` for obsidian.nvim or use a `VeryLazy` event.

© julianobarbosa · MIT · julianobarbosa/claude-code-skills

Похожие скиллы

Все скиллы по теме «Заметки, задачи и проекты» →
obsidian-organizer Agents365-ai Скилл obsidian-organizer для Claude Code и Codex. Раскладывает заметки по папкам хранилища Obsidian и наводит порядок в структуре, когда входящие копятся в корне и нельзя ломать связи между файлами. CX Codex +1 1 900установок obsidian bitbonsai Маршрутизирует работу с хранилищем Obsidian между MCP-сервером, CLI приложения и git. Помогает безопасно переименовывать заметки, обновлять теги и делать бэкапы. CX Codex +1 1 700установок obsidian-headless obsidianmd Скилл obsidian-headless для Claude Code запускает синхронизацию и публикацию хранилищ Obsidian через терминал без графического приложения. Он выполняется на сервере, в CI и в песочнице. CX Codex +1 1 200установок obsidian-notes-creator szeyu Скилл obsidian-notes-creator создаёт, дополняет и проверяет учебные заметки Obsidian по лекциям, учебникам и PDF-файлам. Форматирует конспекты с LaTeX-формулами, диаграммами Mermaid и подробными решениями задач. CX Codex +1 689установок obsidian-markdown AgriciDaniel Скилл obsidian-markdown объясняет, черновики и проверяет синтаксис Obsidian Flavored Markdown: свойства, wikilinks, вставки, callouts, теги, блоки, математику и Mermaid. CX Codex +1 593установок obsidian-bases AgriciDaniel Скилл obsidian-bases помогает составлять, проверять и редактировать файлы .base в Obsidian с фильтрами, формулами и разными типами представлений. CX Codex +1 547установок

Из того же набора37

Весь набор →
shellcheck Скилл shellcheck находит синтаксические ошибки, проблемы с кавычками и несовместимости с POSIX в bash- и sh-скриптах, а также генерирует готовые diff-исправления. CX Codex +1 129установок shell-prompt Скилл shell-prompt для Claude Code собирает конфиги zsh-промпта Powerlevel10k и vi-режима с формой курсора и индикаторами NORMAL/INSERT. CX Codex +1 125установок azure-ad-sso Скилл azure-ad-sso проводит приложение в Kubernetes через вход Azure AD (Entra ID) по OAuth2/OIDC: App Registration, группы, клиентский секрет в Key Vault. CX Codex +1 124установок mimir Скилл объясняет агенту, как развернуть Grafana Mimir в Kubernetes и подключить S3, GCS или Azure Blob для долгого хранения метрик Prometheus. CX Codex +1 118установок repomix Скилл repomix упаковывает репозиторий в один файл, который читает LLM: отбор файлов, сжатие до сигнатур, подсчёт токенов. Пригодится перед ревью и когда код надо втиснуть в контекст. CX Codex +1 115установок managing-infra Скилл managing-infra помогает выбрать между Helm и Kustomize, настроить модули Terraform и применить базовые стандарты безопасности в Kubernetes. CX Codex +1 115установок iterm2 Настраивает iTerm2 и tmux, управляет панелями и сессиями и разбирает неполадки. Помогает работать с терминалом на macOS. CX Codex +1 115установок context7 Скилл ищет документацию и примеры кода для конкретной версии библиотеки через Context7. Пригодится перед написанием кода по API, в котором вы не уверены. CX Codex +1 114установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой