| name | wiki-ingest |
| description | Use when adding a new source to a wiki — a paper, article, URL, file, transcript, or any document. One ingest may touch 5-15 wiki pages. |
Wiki Ingest
Add a source to the wiki. Read it, discuss with the user, write/update wiki pages, update index, and log.
Pre-condition
Search for CLAUDE.md starting from the current directory and upward. If not found, tell the user to run wiki-init first.
Read CLAUDE.md to learn: wiki root path, page frontmatter format, cross-reference convention, log entry format, index table format.
Process
1. Accept the source
The source can be:
- File path — read it directly from
raw/
- URL — use the
agent-browser skill to fetch it; save to raw/<slug>.<ext> if needed
- Pasted text — use what was provided
2. Read the source in full
Read all content. For long sources, read in sections. Do not skip.
3. Surface takeaways — BEFORE writing anything
Tell the user:
- 3-5 bullet points of key takeaways
- What entities/concepts this introduces or updates
- Whether it contradicts anything already in the wiki (read
wiki/index.md and relevant pages to check)
Ask: "Anything specific you want me to emphasize or de-emphasize?"
Wait for the user's response before proceeding.
4. Network supplement (recommended)
For core concepts or key claims, use agent-browser skill to fetch current authoritative sources. Prioritize by category:
- General concepts: en.wikipedia.org / zh.wikipedia.org
- Tech/Programming: docs.python.org, developer.mozilla.org, arxiv.org, github.com
- AI/ML Papers: arxiv.org, paperswithcode.com, huggingface.co
- News/Current Events: reuters.com, bbc.com, theguardian.com
- Academic: scholar.google.com, semanticscholar.org
- Official docs: prefer the official site for the topic
5. Generate the slug
Lowercase, hyphens, no special characters.
Example: "Attention Is All You Need" → attention-is-all-you-need
6. Write or update wiki pages
Write to wiki/pages/<slug>.md:
---
title: <source title>
tags: [<relevant tags>]
sources: <number of sources>
updated: <today>
---
# <Source Title>
**Source:** <original URL or file path in raw/>
**Date ingested:** <today>
**Type:** <paper | article | transcript | code | other>
## Core Definition
<Definition of core concepts>
## Key Takeaways
- <bullet>
## Related Topics
- [[related-slug]] — <relationship>
## Open Questions
<If any>
7. Update related entity/concept pages
For each entity/concept touched by this source:
- Page exists: Read it, add to or update the relevant section, update
updated date
- Page doesn't exist: Create it with the same frontmatter format
8. Backlink audit — do not skip
Scan ALL existing pages in wiki/pages/ for any that mention this source's entities/concepts but don't yet link to the new page. Add [[new-slug]] references where appropriate.
This is the step most commonly skipped. A compounding wiki's value comes from bidirectional links.
9. Update wiki/index.md
Add or update entry in the table format:
## Wiki Pages
| Page | Summary | Tags | Last Updated |
|------|---------|------|--------------|
| [[<slug>]] | One-line description | tag1, tag2 | <today> |
For any new entity/concept pages created, add those too.
10. Append to wiki/log.md
Always append — do not ask permission:
## [<today>] ingest | <source title>
- Created/Updated pages: xxx, yyy
- Web verification: yes/no, source: <url>
- Key findings: ...
11. Report to user
- Summary page:
wiki/pages/<slug>.md
- Entity/concept pages created or updated:
- Pages that received backlinks:
- Index updated
