# Kb Ingest

> Use when a new source document has been added to a KB's raw/ folder and needs to be filed into the wiki — read the source, write its summary page, create or update concept and entity pages, update the index and log, and lint.

- Skill: `hogu-dev/kb-ingest` (Agent Skill)
- Install (CLI): `npx skillmds@latest add hogu-dev/kb-ingest`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hogu-dev/kb-ingest/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: hogu-dev (https://skillmd.com/u/hogu-dev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hogu-dev/kb-ingest

---


# kb-ingest

Ingest a source document into an `llmkb` knowledge base: turn it into a summary
page and fold its ideas into the concept and entity pages, keeping the index,
log, and links consistent.

## When to use

A user has dropped a file in the KB's `raw/` directory (or points you at one)
and wants it filed into the wiki.

## Steps

1. **Read the discipline.** Open `SCHEMA.md` at the KB root and follow its
   conventions for this project.
2. **Read the source** in `raw/`. Identify the key claims, entities, and
   concepts.
3. **Write the summary page** under `wiki/summaries/`. Use the required
   frontmatter (`type: summary`; `sources` lists the `raw/` path). Keep it a
   faithful condensation, self-contained, with `[[wikilinks]]` to the concepts
   and entities it touches.
4. **Update concept pages** under `wiki/concepts/`: create a page for each new
   cross-cutting idea, or extend an existing one. Agent-authored synthesis is a
   concept page with an empty (or session-ref) `sources`.
5. **Update entity pages** under `wiki/entities/` for people, orgs, systems, or
   products the source introduces or expands.
6. **Update the catalog.** Run `llmkb reindex` to rebuild `wiki/index.md` from
   frontmatter, then append one line to `wiki/log.md`:
   `## [YYYY-MM-DD] ingest | <source title>`.
7. **Lint and fix.** Run `llmkb lint` and resolve every error it reports (broken
   links, orphans, missing-from-index) before finishing.

## Done when

`llmkb lint` reports no errors and the source is represented by a summary page
plus any concept/entity updates, all linked and indexed.