Ingest

Ingest — integrate a source into the wiki

Take one source from raw/ and compile it into the wiki: summary page, entity/concept updates, cross-references, index, log.

Usage

/tiro:ingest [file path, URL, or description]

If no argument is given, look for files added to raw/ in the last 24 hours and let the user pick.

Workflow

1. Locate the source. If it's a URL, fetch it and save a markdown copy into the right raw/ subfolder first — raw/ is the source of truth, the wiki never links to content that could disappear.
2. Read it fully. PDFs: extract text. Images: view them separately after the text pass.
3. Discuss briefly. Show the user a 3–5 line summary and ask what matters most to them about it. Their angle belongs in the wiki; a summary without their context is just compression.
4. Write the source page in wiki/sources/:

• Filename: lowercase-english-with-hyphens.
• Frontmatter must include source_path (back-reference to the raw file), plus title, type, date, tags per the wiki's schema.
• Sections: core summary, key points, connections, notable quotes (short, attributed).

1. Update the graph. Read index.md to see what exists, then:

• Update or create entity pages for people/orgs the source discusses.
• Update or create concept pages for ideas it introduces.
• Update topic pages it bears on.
• A single source typically touches 5–15 pages. That's the point — this is where compounding happens.

1. Cross-reference both ways. New page links to existing pages; existing pages get back-links. If the source contradicts something already in the wiki, record the contradiction explicitly on both pages — do not silently overwrite.
2. Index, log, overview. Add new pages to index.md, append a log entry (## [YYYY-MM-DD] ingest | Title with created/modified page lists), refresh overview.md counts.
3. Report. List every file touched. Offer to commit if the wiki is a git repo.

Quality bar

• At least 2 cross-connections per source — actively hunt for them.
• Contradictions and surprises are the most valuable things to record; never smooth them over.
• Follow the wiki's schema file (CLAUDE.md / AGENTS.md) for language and formatting rules; it wins over this skill on any conflict.

Batch mode

For many sources at once: create source pages in parallel if you use subagents, but never let two writers touch shared files (index.md, log.md, entity/concept/topic pages). Merge those sequentially at the end.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: plato-corp
• Source: plato-corp/skills
• License: MIT

Install and usage instructions live in the source repository linked above.