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

wiki-ingest · thoreinstein — скилл для Claude Code: что делает и как установить

Скилл wiki-ingest разбирает внешние документы, PDF и выгрузки Readwise на атомарные заметки базы Obsidian с проверкой дубликатов через RAG и учётом источников.

ISC ★ 102 обновлён 2026-10-25

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

Что делает wiki-ingest

Скилл сканирует указанные пути к файлам на диске или внутренние заметки хранилища. Перед обработкой он проверяет файл .manifest.json в корне Obsidian: если документ уже добавлен и не менялся с даты предыдущего импорта, обработка пропускается, пока пользователь не передаст флаг --force.

Из текста извлекаются паттерны, антипаттерны, архитектурные решения и ключевые концепции. Каждому фрагменту назначается тип происхождения: прямой факт из текста, вывод ^[inferred] или спорное утверждение ^[ambiguous]. Поиск существующих дублей идёт через вызов obsidian_rag_query. Если концепция уже описана, скилл предлагает объединить информацию, иначе создаёт отдельный файл в папках Engineering/Patterns/, Engineering/Traps/ или Engineering/Decisions/.

Перед внесением правок агент обязательно выводит пользователю план изменений со списками новых и обновляемых заметок. Без инструментов интеграции с Obsidian вроде obsidian_read_note и obsidian_rag_query скилл работать не сможет.

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

  • дистиллировать статьи и PDF в заметки базы Obsidian
  • предотвратить дублирование существующих концепций с помощью RAG-поиска
  • отслеживать происхождение тезисов с пометками гипотез и выводов
  • вести реестр обработанных источников в .manifest.json

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

  • Разбери документ /wiki-ingest ~/Documents/architecture-paper.pdf
  • Импортируй конспект в базу /wiki-ingest working/appiary/knowledge/auth-notes.md
  • Перечитай заново источник /wiki-ingest --force ~/Documents/paper.pdf

Как установить wiki-ingest

1Через Skills CLI (Vercel)

npx skills add thoreinstein/gemini-obsidian --skill wiki-ingest -a claude-code

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

~/.claude/skills/wiki-ingest/SKILL.md

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

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

Вопросы о wiki-ingest

Как установить wiki-ingest в Claude Code?

Выполните команду npx skills add thoreinstein/gemini-obsidian --skill wiki-ingest -a claude-code в терминале.

Что делает скилл wiki-ingest?

Он считывает внешние файлы, ищет дубликаты через RAG по базе Obsidian, формирует план создания или слияния заметок и сохраняет структурированные выжимки с метаданными.

Куда попадают извлечённые заметки?

Общие шаблоны и решения сохраняются в папки Engineering/Patterns/, Engineering/Traps/ и Engineering/Decisions/, а проектные данные — в каталог working/<project>/knowledge/.

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

SKILL.md · ISC
---
name: wiki-ingest
description: >-
  Use when the user wants to ingest external sources into the vault — PDFs,
  markdown files, transcripts, Readwise exports, or any document. Triggers on
  "ingest", "process document", "import into vault", "distill this", "add to
  vault", or "extract knowledge from".
---

# Wiki Ingest

Distill external sources into vault-native notes following VAULT_CONVENTIONS, with provenance tracking and deduplication.

## Workflow

### 1. Identify Sources

Accept one or more source paths from the user. Sources can be:
- Files on disk (markdown, PDF, text, transcripts)
- Vault-internal notes (Readwise highlights, working notes to promote)
- A directory to scan for ingestible files

For vault-internal sources, use `obsidian_read_note`. For external files, use the `Read` tool.

### 2. Check Manifest

Read `.manifest.json` from the vault root using `Read` tool.

For each source path, check if it exists in `sources`:
- **Not present** → new source, proceed to extract
- **Present but source modified since `ingested_at`** → re-ingest
- **Present and unchanged** → skip (tell user "already ingested, use --force to re-process")

### 3. Extract Knowledge

Read the source content. Identify:
- **Patterns** — reusable approaches, techniques, or practices
- **Traps** — pitfalls, anti-patterns, things that went wrong
- **Decisions** — architectural or design choices with rationale
- **Concepts** — definitions, mental models, frameworks

For each extraction, classify its **provenance**:
- **Extracted** (unmarked) — directly stated in the source
- **Inferred** `^[inferred]` — synthesized, generalized, or implied but not stated
- **Ambiguous** `^[ambiguous]` — source is unclear or contradicts other sources

### 4. Deduplicate

For each extracted concept, search the vault:
1. Call `obsidian_rag_query` with the concept name/summary, `limit: 5`
2. If a strong match exists, read the existing note with `obsidian_read_note`
3. Decide: **merge** into existing note or **create** new note

**Merge** when: the existing note covers the same concept and the new source adds information.
**Create** when: no existing note covers this concept, or the angle is sufficiently different.

### 5. Present Plan

Before creating or modifying any notes, present the plan to the user:

```
## Ingest Plan for: <source name>

### New Notes
- Engineering/Patterns/<name>.md — <one-line summary>
- Engineering/Traps/<name>.md — <one-line summary>

### Merge Into Existing
- Engineering/Patterns/<existing>.md — adding: <what's new>

### Skipped
- <concept> — already covered in [[existing-note]]
```

Wait for user confirmation before proceeding.

### 6. Write Notes

For **new notes**, use `obsidian_create_note` with content following VAULT_CONVENTIONS templates:

- Set `type:` to pattern, trap, or decision
- Set `project:` to the source project or "general"
- Set `tags:` from content
- Set `created:` to today's date
- Set `provenance:` fractions based on inline marker counts
- Include `## Links` section with `[[wikilinks]]` to related vault notes
- Add `## Sources` section citing the ingested source

For **merges**, use `obsidian_insert_at_heading` or `obsidian_replace_section` to add new content to existing notes. Update the `provenance:` frontmatter if the mix changed, using `obsidian_update_frontmatter`.

### 7. Placement Rules

- Cross-project patterns/traps/decisions → `Engineering/Patterns/`, `Engineering/Traps/`, `Engineering/Decisions/`
- Project-specific knowledge → `working/<project>/knowledge/`
- If unclear, ask the user

### 8. Update Manifest

After all notes are written, update `.manifest.json`:

For each processed source, add/update an entry in `sources`:
```json
{
  "<source-path>": {
    "ingested_at": "<ISO8601 now>",
    "size_bytes": <file size>,
    "modified_at": "<source file mtime>",
    "source_type": "document",
    "pages_created": ["Engineering/Patterns/foo.md"],
    "pages_updated": ["Engineering/Traps/bar.md"]
  }
}
```

Update `stats.total_sources_ingested` and `stats.total_pages`. Set `last_updated` to now.

Write the updated manifest back using the `Write` tool.

### 9. Suggest MOC Updates

For each new Engineering/ note created, check which thematic MOCs it belongs in. Suggest additions but don't auto-edit MOCs — use `/moc-update` for that.

## Arguments

- Source path(s): `/wiki-ingest ~/Documents/paper.pdf`
- Optional project scope: `/wiki-ingest working/appiary/knowledge/auth-notes.md`
- Optional force flag: `/wiki-ingest --force <path>` to re-ingest unchanged sources

## Tips

- Run `/index` first if `obsidian_rag_query` returns poor results
- For Readwise books, ingest the book's highlight file (e.g., `Readwise/Books/<title>.md`)
- Large sources may yield many extractions — review the plan carefully before confirming
- Provenance fractions don't need to be exact; approximate to the nearest 0.05

© thoreinstein · ISC · thoreinstein/gemini-obsidian

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

Все скиллы по теме «Заметки, задачи и проекты» →

Сначала — wiki-ingest от других авторов.

wiki-ingest sanyuan0704 Скилл wiki-ingest для Claude Code собирает статьи, документы и заметки в связанную базу знаний с отдельными страницами сущностей. Пополняет проектную вики из текста, файлов и каталогов. CX Codex +1 2 900установок wiki-ingest Ar9av Скилл wiki-ingest забирает документы, папки, сырой текст и ссылки в вики Obsidian: перерабатывает их в связанные страницы и пропускает то, что уже разобрано. CX Codex +1 3 700установок wiki-ingest AgriciDaniel Скилл wiki-ingest для Claude Code превращает присланный материал в связанные заметки Obsidian, сохраняя происхождение и отслеживая утверждения. Разбирает статью, файл или ссылку и раскладывает по хранилищу. CX Codex +1 555установок llm-wiki akillness Скилл llm-wiki собирает статьи, заметки и расшифровки в связанную markdown-вики с неизменяемыми исходниками. Поддерживает её структуру между сессиями. CX Codex +1 324установок wiki AgriciDaniel Скилл wiki для Claude Code инициализирует и подключает отдельное хранилище Obsidian, а также направляет задачи специализированным вики-скиллам. CX Codex +1 589установок wiki-update Ar9av Скилл wiki-update синхронизирует архитектурные решения и контекст проекта в базу знаний Obsidian. Помогает сохранить выводы и структуру связей между кодом и заметками. CX Codex +1 3 400установок wiki-query Ar9av Скилл wiki-query ищет ответы по скомпилированной базе Obsidian через графовый индекс и синтезирует выводы с цитатами без изменения заметок. CX Codex +1 3 600установок wiki-knowledge-complier bradduy Плагин wiki-knowledge-complier превращает документы в личную базу знаний на markdown-файлах: плагин разбирает источники, строит граф сущностей и отвечает на вопросы по ним. ★ 12звёзд репо wiki-mode AgriciDaniel Скилл wiki-mode определяет методологию хранилища Obsidian (PARA, LYT, Zettelkasten или Generic) и предлагает папки для новых заметок без перезаписи существующих файлов. CX Codex +1 344установок

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

Весь набор →
research Скилл research для Claude Code и Gemini CLI ищет сведения по теме в Obsidian vault, читает заметки и проверяет связанные ссылки. Отвечает на вопросы по собственной базе знаний. CX Codex +1 ★ 102звёзд репо moc-update Скилл moc-update находит карты контента (MOC) в Obsidian-хранилище, куда стоит добавить ссылку на только что созданную заметку из Engineering/. Срабатывает на фразы «update MOC», «add to MOC», «which MOCs». CX Codex +1 ★ 102звёзд репо link-audit Скилл link-audit находит битые ссылки и изолированные заметки в базе Obsidian. Помогает исправить пути или связать страницы семантическим поиском. CX Codex +1 ★ 102звёзд репо knowledge Скилл knowledge для Claude Code ищет повторяющиеся знания в заметках разных проектов и предлагает оформить их общей заметкой в Engineering/. Собирает идеи для переноса между проектами. CX Codex +1 ★ 102звёзд репо journal Скилл journal для дневника Obsidian: показывает сегодняшнюю заметку, дописывает быстрые логи и собирает обзоры за неделю или за день работы в CLI. CX Codex +1 ★ 102звёзд репо obsidian-companion Скилл obsidian-companion подключает агент к хранилищу Obsidian: позволяет искать заметки, вести ежедневные записи и отвечать на вопросы по базе через локальный RAG. CX Codex +1 ★ 102звёзд репо cross-linker Скилл cross-linker находит упоминания понятий из Obsidian vault без wikilinks и помогает связать заметки. Удобен, когда нужно проставить ссылки в выбранной папке или во всём хранилище. CX Codex +1 ★ 102звёзд репо vault-lint Скилл vault-lint проверяет хранилище Obsidian по пяти направлениям: фронтматтер, происхождение заметок, устаревшие источники, покрытие MOC и сироты. CX Codex +1 ★ 102звёзд репо

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

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