wiki-ingest-pdf

Wiki Ingest PDF

Add one or more PDFs as first-class wiki sources: folder layout, extraction, structured analysis, index update, and ingest in one repeatable pipeline.

Required sub-skills (read before starting):

• geronimo-skills:pdf-parse — extraction tool selection and xberg invocation
• geronimo-skills:research-paper — structured analysis pipeline and anti-slop
• geronimo-skills:kb-conventions — frontmatter schema, annotation markers, layout
• llm-wiki:bootstrap — orient to the target wiki before touching files
• llm-wiki:content — create and update wiki pages with correct frontmatter

Step 0 — Orient to the wiki

Run llm-wiki:bootstrap for the target wiki. Identify:

• Wiki root path (from wiki_config)
• The sources/ section slug and its index.md path
• Existing source slugs (avoid collisions)

Step 1 — Derive slug and paths

From the PDF filename, derive a lowercase-hyphenated slug. Convention: <author>-<short-topic> or <author>-<year>-<short-topic>.

PDF:  Psychisme_modele_constructible_cardon.pdf
Slug: cardon-psychisme

Paths:

<wiki_root>/sources/<slug>/
  original.pdf          ← PDF moved/copied here
  extracted/
    content.md          ← xberg output
  analysis/
    <slug>.md           ← structured analysis
    README.md           ← analysis index
  source.md             ← wiki page (paper.json schema)

Step 2 — Create folder layout and move PDF

mkdir -p <wiki_root>/sources/<slug>/extracted
mkdir -p <wiki_root>/sources/<slug>/analysis
mv <inbox_path> <wiki_root>/sources/<slug>/original.pdf

If the PDF is already in the right place, skip the move.

Step 3 — Create stub source.md

Use the paper type schema from geronimo-skills:kb-conventions. Fill title, tags, read_when from the filename and any known context. Set status: draft, confidence: 0.0, leave tldr and claims empty.

Step 4 — Extract PDF

Follow geronimo-skills:pdf-parse to select the right tool.

xberg (machine-readable PDFs):

# Detect
pdfinfo original.pdf   # check Characters: > 0

# Extract — xberg writes WARN lines to stdout; redirect and strip
xberg extract original.pdf --content-format markdown --page-markers true \
  > /tmp/<slug>_raw.md
grep -vE "^WARN" /tmp/<slug>_raw.md > extracted/content.md

# Verify
wc -w -l extracted/content.md   # sanity: > 500 words for a real doc