Wiki Ingest
Turn one source document into durable, interlinked wiki knowledge.
Inputs
- An operation issue with
operationType: "ingest" assigned to you.
- A
raw/ path mentioned in the issue body (always treat raw/ as immutable).
- The operation issue's target
wikiId, spaceSlug, and space root (otherwise stop and surface the missing config to the requester).
Workflow
- Read context first.
- Read the target space's
AGENTS.md for page conventions (filenames, frontmatter, voice, citation style).
- Read the target space's
wiki/index.md to see what already exists.
- Read the target space's last ~20 entries of
wiki/log.md to avoid re-ingesting a source or re-resolving a contradiction someone else already filed.
- Read the source end to end with
wiki_read_source, passing the operation issue's wikiId and spaceSlug. Do not skim. Note the source's structure, claims, dates, and anything that contradicts existing pages.
- Plan, then confirm — but only if the user is in the loop. If the operation came from a routine (no live user), proceed. If a user is asking interactively, summarise the 3–5 takeaways you intend to file and ask which to emphasise before writing.
- Write the source page at
wiki/sources/<slug>.md — ~300–800 words, frontmatter per the wiki schema, neutral voice, key claims with quoted excerpts where they carry weight. The source page is the canonical citation target for everything else this skill writes.
- Update or create downstream pages in
entities/, concepts/, and synthesis/. A typical ingest touches 5–15 pages; resist creating pages for ideas that only appear once.
- Wire the cross-links. Every claim that comes from the source cites it as
(see [[wiki/sources/<slug>]]). Every entity / concept mentioned by name on more than one page links to its dedicated page.
- Flag contradictions; do not silently overwrite. When new material disagrees with an existing page, append a
> ⚠ contradicted by [[wiki/sources/<slug>]] (YYYY-MM-DD) callout to the older page and note the conflict in the log.
- Refresh
wiki/index.md with one-line summaries for any new pages.
- Append a log entry in
wiki/log.md:## [YYYY-MM-DD] ingest | <source title>
- source: raw/<filename>
- new pages: [[...]], [[...]]
- updated pages: [[...]], [[...]]
- notes: <one-line synthesis or open question>
Voice
- Terse, factual, neutral. Reference material, not narrative.
- No "Today I learned" or "This is interesting because" framing.
- Quote the source verbatim when paraphrasing would lose precision.
Verification
Before closing the operation issue:
Tools
wiki_list_sources, wiki_read_source, wiki_search, wiki_read_page, wiki_write_page. Always include the operation issue's wikiId and spaceSlug.
1---
2name: wiki-ingest
3description: Use when an operation issue asks to ingest a captured `raw/` source into the LLM Wiki, or the user says "ingest <slug>". Create durable source, entity, concept, synthesis, index, and log pages; use paperclip-distill for Paperclip bundles.
4metadata:
5 source: https://skillmd.com/skills/paperclipai/wiki-ingest
6---
7
8# Wiki Ingest
9
10Turn one source document into durable, interlinked wiki knowledge.
11
12## Inputs
13
14- An operation issue with `operationType: "ingest"` assigned to you.
15- A `raw/` path mentioned in the issue body (always treat `raw/` as immutable).
16- The operation issue's target `wikiId`, `spaceSlug`, and space root (otherwise stop and surface the missing config to the requester).
17
18## Workflow
19
201. **Read context first.**
21 - Read the target space's `AGENTS.md` for page conventions (filenames, frontmatter, voice, citation style).
22 - Read the target space's `wiki/index.md` to see what already exists.
23 - Read the target space's last ~20 entries of `wiki/log.md` to avoid re-ingesting a source or re-resolving a contradiction someone else already filed.
242. **Read the source end to end** with `wiki_read_source`, passing the operation issue's `wikiId` and `spaceSlug`. Do not skim. Note the source's structure, claims, dates, and anything that contradicts existing pages.
253. **Plan, then confirm — but only if the user is in the loop.** If the operation came from a routine (no live user), proceed. If a user is asking interactively, summarise the 3–5 takeaways you intend to file and ask which to emphasise before writing.
264. **Write the source page** at `wiki/sources/<slug>.md` — ~300–800 words, frontmatter per the wiki schema, neutral voice, key claims with quoted excerpts where they carry weight. The source page is the canonical citation target for everything else this skill writes.
275. **Update or create downstream pages** in `entities/`, `concepts/`, and `synthesis/`. A typical ingest touches 5–15 pages; resist creating pages for ideas that only appear once.
286. **Wire the cross-links.** Every claim that comes from the source cites it as `(see [[wiki/sources/<slug>]])`. Every entity / concept mentioned by name on more than one page links to its dedicated page.
297. **Flag contradictions; do not silently overwrite.** When new material disagrees with an existing page, append a `> ⚠ contradicted by [[wiki/sources/<slug>]] (YYYY-MM-DD)` callout to the older page and note the conflict in the log.
308. **Refresh `wiki/index.md`** with one-line summaries for any new pages.
319. **Append a log entry** in `wiki/log.md`:
32 ```
33 ## [YYYY-MM-DD] ingest | <source title>
34 - source: raw/<filename>
35 - new pages: [[...]], [[...]]
36 - updated pages: [[...]], [[...]]
37 - notes: <one-line synthesis or open question>
38 ```
39
40## Voice
41
42- Terse, factual, neutral. Reference material, not narrative.
43- No "Today I learned" or "This is interesting because" framing.
44- Quote the source verbatim when paraphrasing would lose precision.
45
46## Verification
47
48Before closing the operation issue:
49
50- [ ] Source page exists at `wiki/sources/<slug>.md` with valid frontmatter and a `sources:` field pointing to the raw path.
51- [ ] Every new or updated page links back to the source page or a downstream page that does.
52- [ ] `wiki/index.md` lists every new page under the right category with a one-line summary.
53- [ ] `wiki/log.md` has the ingest entry with the exact filename heading format (so `grep "^## \[" wiki/log.md` keeps working).
54- [ ] Any contradiction between the new source and an older page is annotated, not silently overwritten.
55- [ ] No file under `raw/` was modified.
56
57## Tools
58
59`wiki_list_sources`, `wiki_read_source`, `wiki_search`, `wiki_read_page`, `wiki_write_page`. Always include the operation issue's `wikiId` and `spaceSlug`.