kinic-wiki-ingest

Files (2)

• SKILL.md
• ingest.md

SKILL.md (first lines)

# Kinic Wiki Ingest

Use this skill when the user wants to:

- ingest local markdown, notes, docs, or folders into the wiki
- normalize evidence source material before wiki synthesis
- persist selected source material under `/Sources/...`
- update existing wiki pages from new evidence
- repair existing wiki pages only when the edit is part of source intake; otherwise use `kinic-wiki-edit`
- initialize or repair an explicit LLM Wiki scope when the user asks for scoped structure
- refresh database discovery metadata for public retrieval
- generate conversation wiki pages from evidence sources, preferring one review-ready page unless the source clearly needs a split
- create review-ready wiki pages without pushing immediately

Do not use this skill for:

- ad hoc question answering without source intake
- health-only review of an existing wiki
- hidden publish or push workflows
- OKF Context Pack export after wiki structure exists; use `kinic-context-pack`
- skill store package lifecycle work; use `kinic-skill-registry`
- leakage cleanup or broad existing-node repair without new source ingestion; use `kinic-wiki-edit`

Core rules:

- Treat the canister wiki as the source of truth.
- Organized wiki nodes live under `/Knowledge/...`; evidence sources live under `/Sources/<provider>/<id>.md`.
- Treat local Markdown as review or drafting aid unless the workflow explicitly writes it back through VFS commands.
- Stop at review-ready unless the user explicitly asks for push. `review-ready` means edits and any existing or requested `log.md` updates are complete, but no push or publish step has run.
- Keep source persistence separate from wiki synthesis.
- Hand off to `kinic-context-pack` when the user asks to export a completed `/Knowledge/...` scope for AI handoff.
- For conversation sources, default to one generated wiki page rather than a fixed page scaffold.
- Read current canonical notes before editing them.
- Preserve settled exact fact spans in `facts.md` instead of paraphrasing or normalizing them away.
- Do not rewrite exact values such as dates, money, fractions, spellings, product names, or role labels when a settled source span already exists.
- `facts.md` is not a transcript dump. Exclude gratitude, acknowledgements, question phrasing, tentative future plans, scheduled meetings, deadlines, and dated event lines unless they are being routed to their canonical note.
- When a relevant `log.md` already exists or the user asks for logging, update it append-only.
- Do not create `log.md` by default.
- PDF handling stays inside kinic-wiki-ingest as source normalization.
- Use the embedded note-role rules in `ingest.md` as the trust model. When this skill runs inside the repo and `docs/STORE_API.md` is available, use that file only as the current repo-local refinement.

Read [ingest.md](ingest.md) before doing substantive Kinic Wiki ingest work.

For bounded repeated inspection, repair, and reinspection, use `kinic-wiki-maintain`. `index.md` is an agent catalog; optional `overview.md` is the reader description.

From ICME-Lab/kinic-wiki, MIT.

More from ICME-Lab/kinic-wiki