obsidian2epub — скилл для Claude Code: что делает и как установить
Скилл obsidian2epub конвертирует хранилища Obsidian в электронные книги EPUB с сохранением вики-ссылок, диаграмм Mermaid и вложений.
MIT 1 установок обновлён 2026-04-09
npx skills add Unintendedsideeffects/Skills-And-Agents --skill obsidian2epub -a claude-codeЧто делает obsidian2epub
Ассистент запускает скрипт scripts/convert.sh, собирая заметки Markdown из хранилища Obsidian в готовый файл .epub. Скилл сохраняет внутренние вики-ссылки [[note]], переносит вложенные файлы и выстраивает порядок глав. Упорядочить заметки можно вручную через файл карты содержания (--moc) или автоматически с помощью алгоритма HITS.
Для отрисовки схем Mermaid в формат SVG потребуется глобально установить пакет @mermaid-js/mermaid-cli — без него диаграммы не попадут в книгу. Оформление строится на светлой или тёмной теме Flexoki, а выборку заметок легко отфильтровать регулярными выражениями через --include и --exclude.
Какие задачи решает
- собрать электронную книгу EPUB из заметок Obsidian
- сконвертировать диаграммы Mermaid в SVG внутри книги
- упорядочить главы базы знаний алгоритмом HITS или через MOC-файл
- отфильтровать черновики из итоговой сборки по регулярному выражению
Примеры запросов агенту
- Собери книгу
handbook.epubиз хранилища~/Obsidian/Workс тёмной темой Flexoki - Экспортируй заметки из
~/Notesвbook.epub, исключив папку^Drafts/ - Сконвертируй хранилище
~/Vaultв EPUB и задай порядок глав по файлуIndex.md
Как установить obsidian2epub
1Через Skills CLI (Vercel)
npx skills add Unintendedsideeffects/Skills-And-Agents --skill obsidian2epub -a claude-code2Вручную: положить файлы
~/.claude/skills/obsidian2epub/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/obsidian2epub/
1Через Skills CLI (Vercel)
npx skills add Unintendedsideeffects/Skills-And-Agents --skill obsidian2epub -a codex2Вручную: положить файлы
.agents/skills/obsidian2epub/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Unintendedsideeffects/Skills-And-Agents --skill obsidian2epub -a cursor2Вручную: положить файлы
.cursor/skills/obsidian2epub/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Unintendedsideeffects/Skills-And-Agents skills/obsidian2epub2Вручную: положить файлы
.github/skills/obsidian2epub/SKILL.md1Через Skills CLI (Vercel)
npx skills add Unintendedsideeffects/Skills-And-Agents --skill obsidian2epub -a gemini-cli2Командой платформы
gemini skills install https://github.com/Unintendedsideeffects/Skills-And-Agents --path skills/obsidian2epubВручную: положить файлы
.devin/skills/obsidian2epub/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Unintendedsideeffects/Skills-And-Agents --skill obsidian2epub -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об obsidian2epub
Как установить obsidian2epub в Claude Code?
Выполните команду npx skills add Unintendedsideeffects/Skills-And-Agents --skill obsidian2epub -a claude-code. Конфигурация сохранится в ~/.claude/skills/obsidian2epub/SKILL.md.
Что делает скилл obsidian2epub?
Он автоматизирует запуск CLI-конвертера, превращая хранилище заметок Obsidian в структурированную электронную книгу EPUB со ссылками и иллюстрациями.
Что нужно для отрисовки диаграмм Mermaid в EPUB?
В системе должен быть установлен CLI-пакет Mermaid через npm install -g @mermaid-js/mermaid-cli.
Исходный текст
SKILL.md · MIT
--- name: obsidian2epub description: Convert Obsidian vaults to EPUB ebooks. Use when the user wants to create an ebook from Obsidian notes, export a vault as EPUB, or convert markdown notes to an ebook format. --- # Obsidian2Epub Convert Obsidian vaults to well-structured EPUB ebooks with full support for wikilinks, attachments, and Mermaid diagrams. ## Quick Start ```bash scripts/convert.sh /path/to/vault -o output.epub ``` ## Instructions 1. Get the vault path from the user 2. Determine output EPUB path 3. Ask about optional settings (title, author, theme, filters) 4. Run the conversion using `scripts/convert.sh` 5. Report any warnings (unresolved links, mermaid failures) ## CLI Reference ```bash # Basic conversion scripts/convert.sh /path/to/vault -o book.epub # With options scripts/convert.sh /path/to/vault \ -o book.epub \ --title "Book Title" \ --author "Author Name" \ --moc "Index.md" \ -d # dark Flexoki theme # Interactive TUI scripts/convert.sh --tui ``` ## Options | Option | Description | |--------|-------------| | `-o, --output` | Output EPUB path (required) | | `--title` | Book title (default: vault name) | | `--author` | Author name | | `--moc` | MOC file for chapter ordering | | `-d, --dark` | Dark Flexoki theme | | `--include` | Regex to include files | | `--exclude` | Regex to exclude files | | `--tui` | Launch interactive TUI | ## Features - **Wikilinks**: `[[note]]` becomes internal EPUB links - **Mermaid**: Rendered to SVG (requires `npm install -g @mermaid-js/mermaid-cli`) - **Smart Ordering**: HITS algorithm for chapter order - **Flexoki Themes**: Light (default) and dark ## Examples Convert with custom title: ```bash scripts/convert.sh ~/Obsidian/MyVault -o mybook.epub --title "My Knowledge Base" ``` Include only specific folders: ```bash scripts/convert.sh ~/Obsidian/MyVault -o book.epub --include "^Projects/" ``` Exclude drafts: ```bash scripts/convert.sh ~/Obsidian/MyVault -o book.epub --exclude "^Drafts/" ``` ## Configuration Set `OBSIDIAN2EPUB_DIR` environment variable to override the default installation path: ```bash export OBSIDIAN2EPUB_DIR=/path/to/obsidian2epub ``` ## Troubleshooting **Mermaid not rendering**: Install mermaid-cli: `npm install -g @mermaid-js/mermaid-cli` **Unresolved wikilinks**: Links to notes not in vault are reported as warnings **Missing attachments**: Ensure files exist and paths are correct in notes
© Unintendedsideeffects · MIT · Unintendedsideeffects/Skills-And-Agents