wiki-ingest

Installation
SKILL.md

Wiki — Ingest

Workflow for absorbing one new source into a personal-knowledge-base wiki. Run when the user wants a file (article, paper, book chapter, screenshot, transcript) summarized into the wiki and integrated with existing entity/concept pages.

REQUIRED BACKGROUND: Always load the wiki-conventions skill before doing any work. It defines layout, frontmatter, wikilink rules, the index.md and log.md formats, and the bootstrap procedure. The wiki's own CLAUDE.md (at the wiki root) overrides defaults — read it second.

Preconditions

  1. Run the resolution probe from wiki-conventions to determine which wiki to operate on. The probe handles cwd-detection, walk-up, cache lookup, notes-tooling autodetect, and asking the user. From this point on, refer to the resolved path as the wiki root.
  2. If the resolution probe ended in bootstrap (the user approved initializing a new wiki), proceed against the freshly-bootstrapped wiki root.
  3. The user has identified one source file. If they haven't, ask which file.

One source per ingest. Do not batch.

Workflow

  1. Locate the source. Verify the file exists. If it isn't already under <wiki-root>/raw/, move it to the appropriate subdirectory (raw/articles/, raw/papers/, raw/books/, raw/transcripts/) and tell the user where you put it. Use git mv if the wiki is a git repo. Never edit the source — raw/ is read-only.

  2. Read the source. For PDFs use the Read tool's pages parameter and read iteratively. For long markdown/text, read in chunks. For images embedded in markdown, surface them to the user only if needed for understanding — don't load every image.

Installs
2
Repository
tuongaz/skills
First Seen
Apr 29, 2026
wiki-ingest — tuongaz/skills