Idea Ingest Skill

Filing rule: Read skills/_brain-filing-rules.md before creating any new page.

Contract

This skill guarantees:

• Every ingested item has a brain page with genuine analysis (not just a summary)
• The author is always credited: back-linked from an existing people/ page (timeline update), or inline on the ingested page (**Author:** {Author}, {role}) when no page exists. A NEW people/ page is created only when the author passes the notability gate AND you have at least two independent, durable facts about them beyond this one item, never a stub (skills/_brain-filing-rules.md §Notability Gate)
• Cross-links created bidirectionally (source ↔ author, source ↔ mentioned entities)
• Raw source preserved for provenance via gbrain files upload-raw
• Every fact has an inline [Source: ...] citation
• Filing follows primary subject rules (not format-based)

Returns (when invoked by another skill or sub-agent):

• page_path: brain page path of the ingested item (e.g., concepts/flywheel-effects)
• author_path: brain page path of the author (e.g., people/alice-example), or null when the notability gate was skipped and the author was credited inline instead
• cross_links: list of all cross-links created
• status: ingested | updated | fetch_failed

Convention: See skills/conventions/quality.md for Iron Law back-linking.

Every mention of a person or company with a brain page MUST create a back-link. Format: - **YYYY-MM-DD** | Referenced in [page title](path), brief context

Phases

1. Fetch the content. Use appropriate tools for the content type (web fetch for articles, API for tweets, PDF reader for documents).

2. Upload raw source. Save the fetched content for provenance: gbrain files upload-raw <file> --page <slug>