Obsidian Skills (kepano) — Сценарии использования, Установка & Живое демо

Name: Obsidian Skills (kepano) (Claude Skill)
Author: kepano

Зачем использовать

Ключевые функции

Конвенции Markdown, которых придерживаются реальные пользователи Obsidian
Bases (Obsidian 1.10+) — коллекции с определённой схемой
JSON Canvas — визуальные карты заметок
Паттерны Obsidian CLI для пакетных операций
Идиомы Property/frontmatter

Живое демо

Как выглядит на практике

готово

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "obsidian-skills-kepano": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/kepano/obsidian-skills",
        "~/.claude/skills/obsidian-kepano"
      ],
      "_inferred": true
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "obsidian-skills-kepano": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/kepano/obsidian-skills",
        "~/.claude/skills/obsidian-kepano"
      ],
      "_inferred": true
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "obsidian-skills-kepano": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/kepano/obsidian-skills",
        "~/.claude/skills/obsidian-kepano"
      ],
      "_inferred": true
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "obsidian-skills-kepano": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/kepano/obsidian-skills",
        "~/.claude/skills/obsidian-kepano"
      ],
      "_inferred": true
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "obsidian-skills-kepano",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/kepano/obsidian-skills",
        "~/.claude/skills/obsidian-kepano"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "obsidian-skills-kepano": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/kepano/obsidian-skills",
          "~/.claude/skills/obsidian-kepano"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add obsidian-skills-kepano -- git clone https://github.com/kepano/obsidian-skills ~/.claude/skills/obsidian-kepano

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Obsidian Skills (kepano)

Навести порядок в запутанном хранилище Obsidian с согласованными свойствами

👤 Давние пользователи Obsidian ⏱ ~60 min intermediate

Когда использовать: Годы заметок — несовместимые теги, свойства, именование файлов.

Предварительные требования

Путь к хранилищу Obsidian — Укажите skill на него

Поток

Аудит

Use obsidian-skills. Audit /vault — list inconsistencies in properties, dead links, orphan notes.✓ Скопировано

→ Инвентарь проблем
Нормализация

Migrate tag: to YAML tags: properties consistently.✓ Скопировано

→ Diff по затронутым заметкам
Проверка

Re-audit. Confirm orphans have homes and properties are consistent.✓ Скопировано

→ Чистый аудит

Итог: Хранилище, по которому можно чисто искать и создавать ссылки.

Подводные камни

Массовые правки ломают плагины — Сначала тестируйте на копии; skill это предлагает

Сочетать с: filesystem

Преобразовать папку заметок в Obsidian Base

👤 Пользователи, переходящие на Bases для отслеживания проектов ⏱ ~45 min intermediate

Когда использовать: Нужно типизированное представление над заметками проекта.

Поток

Схема

Look at /vault/projects. Propose a Base schema — properties, types, defaults.✓ Скопировано

→ Спецификация схемы
Миграция

Update each project note to conform. Backfill defaults where missing.✓ Скопировано

→ Заметки соответствуют; представление Base работает

Итог: Работающий Base; можно сортировать, фильтровать, группировать проекты.

Подводные камни

Несоответствия типов свойств — Skill валидирует типы — исправьте помеченные заметки перед чистой загрузкой Base

Сгенерировать JSON Canvas связанных заметок по теме

👤 Исследователи / авторы ⏱ ~30 min intermediate

Когда использовать: Нужна визуальная карта того, как заметки по теме связаны друг с другом.

Поток

Кластеризация

Find notes related to 'distributed systems'. Cluster by sub-topic.✓ Скопировано

→ Список кластеров
Рендеринг

Render as a JSON Canvas with grouped boxes and edges for backlinks.✓ Скопировано

→ .canvas-файл записан

Итог: Canvas, который можно открыть в Obsidian и исследовать визуально.

Подводные камни

Перекрытие элементов в раскладке — Skill включает базовую авторасстановку; доработайте в Obsidian

Комбинации

Сочетайте с другими MCP — эффект x10

obsidian-skills-kepano + filesystem

Прямой доступ к файлам для правок в хранилище

Read/write notes via filesystem; obsidian-skills handles conventions.✓ Скопировано

obsidian-skills-kepano + claude-obsidian-skill

Наложить на Claude×Obsidian skill от Daniel'а

Use both — kepano for conventions, claude-obsidian for daily workflow.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
audit_vault	path	Периодическая уборка	tokens scaled to vault size
design_base	folder	Переход на Bases	tokens
render_canvas	note_set, layout?	Визуальные карты	tokens
obsidian_cli	command	Пакетные операции через CLI	tokens for parsing output

Стоимость и лимиты

Во что обходится

Квота API: N/A
Токенов на вызов: Много на больших хранилищах; помогает ограничение по папкам
Деньги: Бесплатно
Совет: При первом запуске аудируйте по папкам, а не всё хранилище целиком

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: Read/write to vault

Хранение учётных данных: Нет

Исходящий трафик: Нет

Личные заметки — будьте внимательны с тем, что вставляете в чат с облачными агентами

Устранение неполадок

Частые ошибки и исправления

Bases schema rejected

Типы свойств должны совпадать во всех заметках — skill отмечает нарушителей

Canvas overlaps

Уменьшите размер кластера или откройте в Obsidian для ручной доработки

CLI command not found

Установите Obsidian CLI отдельно; skill предполагает наличие в PATH

Альтернативы

Obsidian Skills (kepano) в сравнении

Альтернатива	Когда использовать	Компромисс
claude-obsidian-skill	Нужны паттерны повседневного рабочего процесса	Меньше охват новых функций Bases / Canvas
Manual Obsidian usage	Небольшое хранилище	Не масштабируется на тысячи заметок

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills