# Idea Ingest

Ingest links, articles, tweets, and ideas into the brain.

- Repository: https://github.com/garrytan/gbrain (31427 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add garrytan/gbrain --skill idea-ingest -g -a claude-code -y`
Codex: `npx skills add garrytan/gbrain --skill idea-ingest -g -a codex -y`
Cursor: `npx skills add garrytan/gbrain --skill idea-ingest -g -a cursor -y`
Gemini CLI: `npx skills add garrytan/gbrain --skill idea-ingest -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add garrytan/gbrain`

## Description

Ingest links, articles, tweets, and ideas into the brain. Fetch content, save to brain with analysis, credit the author (people page only when they pass the notability gate), and cross-link. Use when the user shares a link or says "read this", "save this", "think about this".

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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>`

The rest: https://github.com/garrytan/gbrain/blob/HEAD/plugin-variants/gbrain-coding/skills/idea-ingest/SKILL.md