# kb-ingest

Читает заметку, письмо, PDF или веб-страницу один раз и раскладывает извлечённые сущности и связи по базе knowledge/, чтобы знания не выводились заново на каждый запрос.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 41
- Автор: stjbrown
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/stjbrown/agent-knowledge/tree/HEAD/skills/kb-ingest/SKILL.md
- Обновлён: 2026-08-01
- HTML: https://affpapa.org/nevibecode/skills/kb-ingest

## Что делает

Скилл берёт сырой источник и превращает его в компилируемый артефакт: создаёт и обновляет концепции, перекрёстные ссылки, индексы и лог. Ключевой принцип — база это скомпилированный результат, а не переписанная копия источника. Извлекаются сущности, утверждения и связи, а не пересказ заметки.

Работа идёт по плану: сначала найти базу и прочитать её схему (`spec/types.md`, `spec/conventions.md`), затем классифицировать источник по содержимому и по тому, кто им владеет, и только потом писать. Каждое извлечённое утверждение получает одно из действий: создать, дополнить ссылкой, заменить, отметить конфликт или добавить событие. Перед записью скилл читает модель доверия из `references/trust-model.md` — рассуждать о замещении по памяти он не станет.

Источник становится одной концепцией с `type: Reference`, на неё ссылаются все концепции, которые она поддерживает. Содержимое источника считается данными, а не инструкциями. Если базы ещё нет, скилл останавливается и предлагает `kb-init`. Для PDF в Janet подгружается отдельный скилл `janet-pdf`; в других хостах используется их штатный способ чтения PDF.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add stjbrown/agent-knowledge --skill kb-ingest -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/kb-ingest/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/kb-ingest/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add stjbrown/agent-knowledge --skill kb-ingest -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/kb-ingest/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add stjbrown/agent-knowledge --skill kb-ingest -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/kb-ingest/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install stjbrown/agent-knowledge kb-ingest
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/kb-ingest/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add stjbrown/agent-knowledge --skill kb-ingest -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/stjbrown/agent-knowledge --path skills/kb-ingest
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/kb-ingest/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add stjbrown/agent-knowledge --skill kb-ingest -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/stjbrown/agent-knowledge/tree/HEAD/skills/kb-ingest/SKILL.md

## Когда брать
- зафиксировать расшифровку встречи в базе знаний
- разложить письмо по сущностям и связям
- добавить PDF в `knowledge/` без ручного переписывания
- найти все концепции, зависящие от изменённого утверждения
- отметить конфликт нового утверждения со старым вместо тихой перезаписи

## Примеры запросов агенту
- Добавь эту заметку в базу знаний
- Обработай `transcript.md` и разложи по концепциям
- Занеси эту веб-страницу в `knowledge/`

## Похожие
- [elasticsearch-ingest](https://affpapa.org/nevibecode/skills/elasticsearch-ingest.md) — скилл · 1000 установок
- [claude-history-ingest](https://affpapa.org/nevibecode/skills/claude-history-ingest.md) — скилл · 3000 установок
- [codex-history-ingest](https://affpapa.org/nevibecode/skills/codex-history-ingest.md) — скилл · 2600 установок
- [second-brain-ingest](https://affpapa.org/nevibecode/skills/second-brain-ingest.md) — скилл · 2500 установок
- [wiki-ingest](https://affpapa.org/nevibecode/skills/agricidaniel-wiki-ingest.md) — скилл · 502 установки
- [okf-knowledge-base](https://affpapa.org/nevibecode/skills/okf-knowledge-base.md) — скилл · 9300 установок

Из того же набора: [stjbrown/agent-knowledge](https://affpapa.org/nevibecode/by/stjbrown/agent-knowledge.md) — 2 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md