idea-ingest

name	idea-ingest
version	1.1.0
upstream	idea-ingest@fc834ee
description	Ingest links, articles, tweets, and ideas into the brain. Fetch content, save to brain with analysis, create author people page, and cross-link. Use when the user shares a link or says "read this", "save this", "think about this".
triggers	["shares a link or URL","read this","save this","think about this","put this in brain"]
tools	["search","query","get_page","put_page","add_link","add_timeline_entry","file_upload"]
mutating	true
writes_pages	true
writes_to	["people/","concepts/","sources/"]

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 gets a people page (MANDATORY for anyone whose thinking is worth ingesting)
• 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)
• 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>

3. Identify the author — MANDATORY people page. Anyone whose thinking is worth ingesting is worth tracking.

   • Search brain for existing author page
   • If no page → CREATE ONE with compiled truth + timeline format
   • If page exists → update timeline with this new publication
   • Cross-link both directions

4. Save to brain. File by PRIMARY SUBJECT (read skills/_brain-filing-rules.md):

   • About a person →