wiki-cli — скилл для Claude Code: что делает и как установить
Скилл wiki-cli проверяет, можно ли читать хранилище Obsidian через официальный CLI, и ищет по заметкам. Если CLI не готов, читает файлы напрямую.
MIT 341 установок ★ 16 676 обновлён 2026-10-22
npx skills add AgriciDaniel/claude-obsidian --skill wiki-cli -a claude-codeЧто делает wiki-cli
Скилл решает одну задачу: понять, чем читать хранилище Obsidian, и прочитать или найти нужную заметку. Он запускает scripts/detect-transport.sh с флагом --peek и смотрит на available.cli.usable. Одного бинарника obsidian мало: CLI не отвечает, если приложение закрыто или доступ из командной строки выключен.
Когда CLI готов, команды идут изнутри папки хранилища: obsidian read path=... и obsidian search query=.... Для бэклинков, тегов и результатов Bases есть отдельные команды только для чтения. Когда CLI не готов, агент читает файлы и ищет через rg. Абсолютные пути, обход через .. и симлинки за пределы хранилища отклоняются.
Записывать скилл не умеет. Создание, правка, перенос и удаление заметок через CLI запрещены, прямая запись в файлы тоже. Любое изменение идёт одной проверяемой транзакцией через ядро claude-obsidian, а скрипт детекта скилл ищет в каталоге установленного claude-obsidian, поэтому без него проверка не стартует. Файл .vault-meta/transport.json обновляется с --force только по просьбе.
Какие задачи решает
- проверить, отвечает ли Obsidian CLI, до первой команды
- прочитать заметку по пути внутри хранилища
- найти заметки по запросу через
obsidian search - получить бэклинки и теги, когда CLI готов
- искать по хранилищу через
rg, если CLI недоступен
Примеры запросов агенту
- Проверь через wiki-cli, работает ли Obsidian CLI для моего хранилища
- Найди в хранилище Obsidian заметки про OAuth через wiki-cli
- Прочитай заметку и покажи её бэклинки через Obsidian CLI
Как установить wiki-cli
1Через Skills CLI (Vercel)
npx skills add AgriciDaniel/claude-obsidian --skill wiki-cli -a claude-code2Вручную: положить файлы
~/.claude/skills/wiki-cli/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/wiki-cli/
1Через Skills CLI (Vercel)
npx skills add AgriciDaniel/claude-obsidian --skill wiki-cli -a codex2Вручную: положить файлы
.agents/skills/wiki-cli/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add AgriciDaniel/claude-obsidian --skill wiki-cli -a cursor2Вручную: положить файлы
.cursor/skills/wiki-cli/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install AgriciDaniel/claude-obsidian skills/wiki-cli2Вручную: положить файлы
.github/skills/wiki-cli/SKILL.md1Через Skills CLI (Vercel)
npx skills add AgriciDaniel/claude-obsidian --skill wiki-cli -a gemini-cli2Командой платформы
gemini skills install https://github.com/AgriciDaniel/claude-obsidian --path skills/wiki-cliВручную: положить файлы
.devin/skills/wiki-cli/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add AgriciDaniel/claude-obsidian --skill wiki-cli -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о wiki-cli
Как установить wiki-cli в Claude Code?
Выполните npx skills add AgriciDaniel/claude-obsidian --skill wiki-cli -a claude-code. Файл скилла — ~/.claude/skills/wiki-cli/SKILL.md.
Что делает wiki-cli?
Определяет, доступен ли Obsidian CLI, и читает или ищет по выбранному хранилищу только на чтение. Если CLI не готов, скилл читает файлы напрямую.
Работает ли wiki-cli без запущенного Obsidian?
CLI требует запущенное приложение и включённый доступ из командной строки. Без этого скилл переходит на чтение файлов и поиск через rg.
Исходный текст
SKILL.md · MIT
--- name: wiki-cli description: "Detect and use the official Obsidian command-line interface for read-only vault access; use for wiki-cli, Obsidian CLI, Obsidian read, Obsidian search, vault transport, which transport, transport detection, backlinks, tags, or Obsidian command line. Mutations always go through the claude-obsidian transaction core." --- # Obsidian CLI read transport Use this skill only to detect transport and read or search a selected vault. The official executable is `obsidian`; binary presence alone does not prove it is usable. Resolve the installed product root from this skill's own location, not from the vault or current working directory: ```bash PRODUCT_ROOT=/absolute/path/to/installed/claude-obsidian DETECT_TRANSPORT="$PRODUCT_ROOT/scripts/detect-transport.sh" test -f "$DETECT_TRANSPORT" ``` Every `../wiki/references/` link in this file resolves the same way, relative to this skill's own directory under `$PRODUCT_ROOT`, never relative to the selected vault's `wiki/` directory. ## Detect safely Probe without persisting host state: ```bash bash "$DETECT_TRANSPORT" --peek --vault "$VAULT" ``` Trust `available.cli.usable`, not merely `present` or exit status. A supported CLI can still be unavailable because the Obsidian app is not running, command line access is disabled, or its response is an error. Use filesystem reads as the portable fallback. Persist a refreshed `.vault-meta/transport.json` only when the user or setup workflow asks for a transport snapshot: ```bash bash "$DETECT_TRANSPORT" --force --vault "$VAULT" ``` That file is derived runtime configuration, not knowledge content. Preserve a valid `manual_override` recorded by the detector. ## Read and search Run official CLI commands from the selected vault so Obsidian resolves the correct workspace. Confirm supported syntax with the installed CLI before relying on optional commands. Typical read-only forms are: ```bash (cd "$VAULT" && obsidian read path="$NOTE") (cd "$VAULT" && obsidian search query="$QUERY") ``` Use read-only commands for backlinks, tags, or Bases results only when the detector reports the CLI ready. Otherwise read files under `$VAULT` directly and use `rg` for search. Reject absolute note arguments, traversal, symlinks, or resolved paths outside the selected vault. ## Mutation boundary Do not use CLI create, write, append, property-set, daily-append, move, rename, or delete commands. Do not replace those commands with direct filesystem writes. Any knowledge or configuration change must be expressed as one reviewed transaction through the portable core; see [operation transactions](../wiki/references/operation-transactions.md). Transport choice never changes mutation semantics. The CLI is an optional read surface, not a lock manager, transaction engine, or Git checkpoint mechanism. ## Checkpoint Observe actual capability, think about the least complex read transport, verify that every resolved path stays in the vault, and accept filesystem fallback when the CLI is not ready.
© AgriciDaniel · MIT · AgriciDaniel/claude-obsidian