[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M72SWN2SXKGZS4WARQA6039G":3,"skill-same:01M72SWN2SXKGZS4WARQA6039G":63},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":42,"commitSha":43,"skillDirectory":44,"forksCount":45,"repositoryHtmlUrl":46,"repositoryHomepageUrl":6,"ownerHtmlUrl":47,"ownerBlogUrl":6,"ownerDescription":48,"updatedAt":49,"install":50,"resources":62},"01M72SWN2SXKGZS4WARQA6039G","ingest",null,"Route content to specialized ingestion skills. Detects input type and delegates.","ltdrew\u002FAgent-brain-2","ltdrew","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F173687628?v=4","01M72SVABERGYY99JQPNV3FTTN","Logan Drew","01M72SVABZHAN29CHRV66Y48B8",1,"MIT","https:\u002F\u002Fgithub.com\u002Fltdrew\u002FAgent-brain-2\u002Fblob\u002Ffeat\u002Fbrain-first-convention\u002Fskills\u002Fingest\u002FSKILL.md",[],[],"2026-11-10 22:39:42",false,"---\nname: ingest\ndescription: Route content to specialized ingestion skills. Detects input type and delegates.\ntriggers:\n  - \"ingest this\"\n  - \"save this to brain\"\n  - \"process this meeting\"\ntools:\n  - search\n  - get_page\n  - put_page\n  - add_link\n  - add_timeline_entry\n  - sync_brain\nmutating: true\nwrites_pages: true\nwrites_to:\n  - people\u002F\n  - companies\u002F\n  - concepts\u002F\n  - meetings\u002F\n  - sources\u002F\n---\n\n# Ingest Skill\n\nIngest meetings, articles, media, documents, and conversations into the brain.\n\n> **Filing rule:** Read `skills\u002F_brain-filing-rules.md` before creating any new page.\n\n## Contract\n\n- Every fact written to a brain page carries an inline `[Source: ...]` citation with date and provenance.\n- Every entity mention creates a back-link from the entity's page to the page mentioning them (Iron Law).\n- Raw sources are preserved for provenance via `gbrain files upload-raw` with automatic size routing.\n- State sections are rewritten with current best understanding, never appended to.\n- Entity detection fires on every inbound message; notable entities get pages or updates.\n\n> **Convention:** See `skills\u002Fconventions\u002Fquality.md` for Iron Law back-linking.\n\nEvery mention of a person or company with a brain page MUST create a back-link\nFROM that entity's page TO the page mentioning them. An unlinked mention is a\nbroken brain. See `skills\u002F_brain-filing-rules.md` for format.\n\n## Citation Requirements (MANDATORY)\n\nEvery fact written to a brain page must carry an inline `[Source: ...]` citation.\n\n- **User's statements:** `[Source: User, {context}, YYYY-MM-DD]`\n- **Meeting data:** `[Source: Meeting \"{title}\", YYYY-MM-DD]`\n- **Email\u002Fmessage:** `[Source: email from {name} re: {subject}, YYYY-MM-DD]`\n- **Web content:** `[Source: {publication}, {URL}, YYYY-MM-DD]`\n- **Social media:** `[Source: X\u002F@handle, YYYY-MM-DD](URL)` (include link)\n- **Synthesis:** `[Source: compiled from {sources}]`\n\n## Phases\n\n> **Router note:** This skill is a router. For specialized ingestion, see: idea-ingest, media-ingest, meeting-ingestion.\n\n1. **Parse the source.** Extract people, companies, dates, and events from the input.\n2. **For each entity mentioned:**\n   - Read the entity's page from gbrain to check if it exists\n   - If exists: update compiled_truth (rewrite State section with new info, don't append)\n   - If new: check notability gate, then store the page in gbrain with the appropriate type and slug\n3. **Append to timeline.** Add a timeline entry in gbrain for each event, with date, summary, and source citation.\n4. **Create cross-reference links.** Link entities in gbrain for every entity pair mentioned together, using the appropriate relationship type.\n5. **Back-link all entities.** Update EVERY mentioned entity's page with a back-link to this page (Iron Law).\n6. **Timeline merge.** The same event appears on ALL mentioned entities' timelines. If Alice met Bob at Acme Corp, the event goes on Alice's page, Bob's page, and Acme Corp's page.\n\n## Entity Detection on Every Message\n\nProduction agents should detect entity mentions on EVERY inbound message. This is\nthe signal detection loop that makes the brain compound over time.\n\n### Protocol\n\n1. **Scan the message** for entity mentions: people, companies, concepts, original\n   thinking. Fire on every message (no exceptions unless purely operational).\n2. **For each entity detected:**\n   - `gbrain search \"name\"` -- does a page already exist?\n   - **If yes:** load context with `gbrain get \u003Cslug>`. Use the compiled truth to\n     inform your response. Update the page if the message contains new information.\n   - **If no:** assess notability (see `skills\u002F_brain-filing-rules.md`). If the entity\n     is worth tracking, create a new page with `gbrain put \u003Ctype\u002Fslug>` and populate\n     with what you know.\n3. **After creating or updating pages:** sync to gbrain:\n   ```bash\n   gbrain sync --no-pull --no-embed\n   ```\n4. **Don't block the conversation.** Entity detection and enrichment should happen\n   alongside the response, not before it. The user shouldn't wait for brain writes\n   to get an answer.\n\n### What counts as notable\n\n- People the user interacts with or discusses (not random mentions)\n- Companies relevant to the user's work or interests\n- Concepts or frameworks the user references or creates\n- The user's own original thinking (ideas, theses, observations) -- highest value\n- See `skills\u002F_brain-filing-rules.md` for the full notability gate\n\n### What to capture from the user's own thinking\n\nOriginal thinking is the most valuable signal. Capture exact phrasing -- the user's\nlanguage IS the insight. Don't paraphrase.\n\n- Novel observations or theses\n- Frameworks, mental models, heuristics\n- Connections between ideas that others miss\n- Contrarian positions with reasoning\n- Strong reactions to external stimuli (what triggered it and why)\n\n## Media Workflows\n\nContent the user encounters should be captured in the brain. File by PRIMARY\nSUBJECT, not by format (see `skills\u002F_brain-filing-rules.md`).\n\n### Articles & Web Content\n\n**Input:** URL shared by user, or article mentioned in conversation.\n\n**Process:**\n1. Fetch content (`web_fetch` or equivalent)\n2. Extract: title, author, publication, date, full text\n3. Summarize: executive summary + key arguments (not a rehash)\n4. Extract entities: people, companies, concepts mentioned\n5. **Save raw source** for provenance (see Raw Source Preservation below)\n6. Analyze for the user: don't just summarize. What's interesting given what you\n   know about them? Flag connections, contradictions, content opportunities.\n\n**Write to:** appropriate directory per filing rules (about a person -> `people\u002F`,\nabout a company -> `companies\u002F`, reusable framework -> `concepts\u002F`, raw data -> `sources\u002F`)\n\n### Videos & Podcasts\n\n**Input:** URL (YouTube, podcast, etc.) or local audio\u002Fvideo file.\n\n**Process:**\n1. Get transcript -- speaker-diarized if possible (services like Diarize.io provide\n   speaker-labeled, word-level timing)\n2. **Save raw transcript** (both JSON and human-readable TXT)\n3. Analyze: executive summary, key ideas, key quotes with speaker attribution,\n   notable stories\u002Fanecdotes, people and companies mentioned\n4. Extract and cross-reference all entities mentioned\n5. **HARD RULE:** every video\u002Fpodcast brain page MUST link to the raw diarized\n   transcript. A page without transcript links is incomplete.\n\n**Write to:** `media\u002Fvideos\u002F` or `media\u002Fpodcasts\u002F` with back-links to all entities.\n\n**Quality bar:**\n- Compelling headline (not \"This video discusses...\")\n- Executive summary that makes you want to watch\u002Flisten\n- Key Ideas as actual insights, not topic labels\n- Verbatim quotes with real speaker names (not \"speaker_0\")\n- All entities extracted with context and back-linked\n\n### PDFs & Documents\n\n**Input:** File path or URL.\n\n**Process:**\n1. Extract text (OCR if scanned\u002Fimage PDF)\n2. **Save raw source** for provenance\n3. Summarize: executive summary + key sections + notable data\n4. Extract entities\n5. Cross-reference from entity pages\n\n**Write to:** per filing rules (file by primary subject, not format).\n\n### Screenshots & Images\n\n**Input:** Image file.\n\n**Process:**\n1. Analyze content (OCR for text-heavy images, description for photos)\n2. If tweet screenshot: extract text, author, date, route to social media workflow\n3. If article screenshot: extract text, route to article workflow\n4. If data\u002Fchart: extract data points, describe findings\n\n**Write to:** depends on content -- route to the appropriate workflow above.\n\n### Meeting Transcripts\n\n**Input:** Transcript from meeting recording service, or manual notes.\n\n**Process:**\n1. Pull full transcript (source of truth -- AI summaries are medium-low trust)\n2. **Save raw transcript** for provenance\n3. Write meeting page with YOUR analysis above the line, raw transcript below\n4. **Entity propagation (MANDATORY):** for each attendee and company discussed:\n   - Update their brain page State section if new info surfaced\n   - Append to their Timeline with link to the meeting page\n   - Create page if person\u002Fcompany is notable and has no page yet\n5. A meeting is NOT fully ingested until all entity pages are updated\n\n**Write to:** `meetings\u002FYYYY-MM-DD-short-description.md`\n\n**What makes a good meeting page:**\n- Reveals the real crux, not a bullet dump\n- Connects to existing brain pages (people, companies, deals)\n- Flags what changed (status, decisions, new info)\n- Names tension or what was left unsaid\n- Captures actual dynamic, not performative summary\n\n### Social Media Content\n\n**Input:** Tweet, thread, or social media post.\n\n**Process:**\n1. Fetch full content (thread, quote tweets, context)\n2. If images present: OCR via vision model for full text extraction\n3. Summarize: what's being said, why it matters, who's involved\n4. Extract entities and update brain pages\n5. Include direct link to the original post (MANDATORY for citations)\n\n**Write to:** `media\u002Fx\u002F` for daily aggregation, or entity-specific directories\nif the post is primarily about a person\u002Fcompany.\n\n## Raw Source Preservation\n\nEvery ingested item must have its raw source preserved for provenance.\n\n**Use `gbrain files upload-raw` for automatic size routing:**\n```bash\ngbrain files upload-raw \u003Cfile> --page \u003Cpage-slug> --type \u003Ctype>\n```\n\n- **\u003C 100 MB text\u002FPDF**: stays in git (brain repo `.raw\u002F` sidecar directories)\n- **>= 100 MB OR media** (video, audio, images): uploaded to cloud storage\n  via TUS resumable upload, `.redirect.yaml` pointer left in the brain repo\n\nThe `.redirect.yaml` pointer format:\n```yaml\ntarget: supabase:\u002F\u002Fbrain-files\u002Fpage-slug\u002Ffilename.mp4\nbucket: brain-files\nstorage_path: page-slug\u002Ffilename.mp4\nsize: 524288000\nsize_human: 500 MB\nhash: sha256:abc123...\nmime: video\u002Fmp4\nuploaded: 2026-04-11T...\ntype: transcript\n```\n\n**Accessing stored files:**\n- `gbrain files signed-url \u003Cstorage-path>` -- generate 1-hour signed URL for viewing\u002Fsharing\n- `gbrain files restore \u003Cdir>` -- download back to local from cloud storage\n\nUse `put_raw_data` in gbrain to store raw API responses and metadata (JSON, not binary).\n\n## Test Before Bulk\n\nWhen processing multiple items (batch video ingestion, bulk meeting processing, etc.):\n\n1. **Test on 3-5 items first.** Run in test mode if available.\n2. **Read the actual output.** Is the quality good? Are titles compelling (not\n   \"This video discusses...\")? Are entities extracted and back-linked? Is the\n   format clean?\n3. **Fix what's wrong** in the approach\u002Fskill, not via one-off patches.\n4. **Only then: bulk execute** with throttling, commits every 5-10 items.\n\nThe marginal cost of testing 3 items first is near zero. The cost of cleaning\nup 100 bad pages is enormous.\n\n## Quality Rules\n\n- Executive summary in compiled_truth must be updated, not just timeline appended\n- State section is REWRITTEN, not appended to. Current best understanding only.\n- Timeline entries are reverse-chronological (newest first)\n- Every person\u002Fcompany mentioned gets a page if notable (see filing rules)\n- Link types: knows, works_at, invested_in, founded, met_at, discussed\n- Source attribution: every timeline entry includes [Source: ...] citation\n- Back-links: every entity mention creates a back-link (Iron Law)\n- Filing: file by primary subject, not format or source (see filing rules)\n\n## Anti-Patterns\n\n- **Appending to State sections.** State is rewritten with the current best understanding on every update. Append-only State sections grow stale and contradictory.\n- **Ingesting without back-links.** An unlinked mention is a broken brain. Every entity mentioned must have a back-link from their page to the page mentioning them.\n- **Skipping raw source preservation.** Every ingested item must have its raw source preserved. A brain page without provenance is unverifiable.\n- **Bulk processing without sample test.** Test on 3-5 items first. Fix quality issues in the approach, not via one-off patches.\n- **Paraphrasing the user's original thinking.** The user's exact language IS the insight. Capture verbatim phrasing for ideas, theses, and frameworks.\n\n## Output Format\n\n```\nINGESTED: [title]\n==================\n\nPage: [slug]\nType: [person \u002F company \u002F meeting \u002F media \u002F concept]\nSource: [source description]\n\nEntities detected: N\n- [entity] -> [created \u002F updated] ([slug])\n\nBack-links created: N\nTimeline entries: N\nRaw source: [preserved at path \u002F uploaded to cloud]\n```\n\n## Tools Used\n\n- Read a page from gbrain (get_page)\n- Store\u002Fupdate a page in gbrain (put_page)\n- Add a timeline entry in gbrain (add_timeline_entry)\n- Link entities in gbrain (add_link)\n- List tags for a page (get_tags)\n- Tag a page in gbrain (add_tag)\n- Store raw data in gbrain (put_raw_data)\n- Check backlinks in gbrain (get_backlinks)\n","# Ingest Skill\n\nIngest meetings, articles, media, documents, and conversations into the brain.\n\n> **Filing rule:** Read `skills\u002F_brain-filing-rules.md` before creating any new page.\n\n## Contract\n\n- Every fact written to a brain page carries an inline `[Source: ...]` citation with date and provenance.\n- Every entity mention creates a back-link from the entity's page to the page mentioning them (Iron Law).\n- Raw sources are preserved for provenance via `gbrain files upload-raw` with automatic size routing.\n- State sections are rewritten with current best understanding, never appended to.\n- Entity detection fires on every inbound message; notable entities get pages or updates.\n\n> **Convention:** See `skills\u002Fconventions\u002Fquality.md` for Iron Law back-linking.\n\nEvery mention of a person or company with a brain page MUST create a back-link\nFROM that entity's page TO the page mentioning them. An unlinked mention is a\nbroken brain. See `skills\u002F_brain-filing-rules.md` for format.\n\n## Citation Requirements (MANDATORY)\n\nEvery fact written to a brain page must carry an inline `[Source: ...]` citation.\n\n- **User's statements:** `[Source: User, {context}, YYYY-MM-DD]`\n- **Meeting data:** `[Source: Meeting \"{title}\", YYYY-MM-DD]`\n- **Email\u002Fmessage:** `[Source: email from {name} re: {subject}, YYYY-MM-DD]`\n- **Web content:** `[Source: {publication}, {URL}, YYYY-MM-DD]`\n- **Social media:** `[Source: X\u002F@handle, YYYY-MM-DD](URL)` (include link)\n- **Synthesis:** `[Source: compiled from {sources}]`\n\n## Phases\n\n> **Router note:** This skill is a router. For specialized ingestion, see: idea-ingest, media-ingest, meeting-ingestion.\n\n1. **Parse the source.** Extract people, companies, dates, and events from the input.\n2. **For each entity mentioned:**\n   - Read the entity's page from gbrain to check if it exists\n   - If exists: update compiled_truth (rewrite State section with new info, don't append)\n   - If new: check notability gate, then store the page in gbrain with the appropriate type and slug\n3. **Append to timeline.** Add a timeline entry in gbrain for each event, with date, summary, and source citation.\n4. **Create cross-reference links.** Link entities in gbrain for every entity pair mentioned together, using the appropriate relationship type.\n5. **Back-link all entities.** Update EVERY mentioned entity's page with a back-link to this page (Iron Law).\n6. **Timeline merge.** The same event appears on ALL mentioned entities' timelines. If Alice met Bob at Acme Corp, the event goes on Alice's page, Bob's page, and Acme Corp's page.\n\n## Entity Detection on Every Message\n\nProduction agents should detect entity mentions on EVERY inbound message. This is\nthe signal detection loop that makes the brain compound over time.\n\n### Protocol\n\n1. **Scan the message** for entity mentions: people, companies, concepts, original\n   thinking. Fire on every message (no exceptions unless purely operational).\n2. **For each entity detected:**\n   - `gbrain search \"name\"` -- does a page already exist?\n   - **If yes:** load context with `gbrain get \u003Cslug>`. Use the compiled truth to\n     inform your response. Update the page if the message contains new information.\n   - **If no:** assess notability (see `skills\u002F_brain-filing-rules.md`). If the entity\n     is worth tracking, create a new page with `gbrain put \u003Ctype\u002Fslug>` and populate\n     with what you know.\n3. **After creating or updating pages:** sync to gbrain:\n   ```bash\n   gbrain sync --no-pull --no-embed\n   ```\n4. **Don't block the conversation.** Entity detection and enrichment should happen\n   alongside the response, not before it. The user shouldn't wait for brain writes\n   to get an answer.\n\n### What counts as notable\n\n- People the user interacts with or discusses (not random mentions)\n- Companies relevant to the user's work or interests\n- Concepts or frameworks the user references or creates\n- The user's own original thinking (ideas, theses, observations) -- highest value\n- See `skills\u002F_brain-filing-rules.md` for the full notability gate\n\n### What to capture from the user's own thinking\n\nOriginal thinking is the most valuable signal. Capture exact phrasing -- the user's\nlanguage IS the insight. Don't paraphrase.\n\n- Novel observations or theses\n- Frameworks, mental models, heuristics\n- Connections between ideas that others miss\n- Contrarian positions with reasoning\n- Strong reactions to external stimuli (what triggered it and why)\n\n## Media Workflows\n\nContent the user encounters should be captured in the brain. File by PRIMARY\nSUBJECT, not by format (see `skills\u002F_brain-filing-rules.md`).\n\n### Articles & Web Content\n\n**Input:** URL shared by user, or article mentioned in conversation.\n\n**Process:**\n1. Fetch content (`web_fetch` or equivalent)\n2. Extract: title, author, publication, date, full text\n3. Summarize: executive summary + key arguments (not a rehash)\n4. Extract entities: people, companies, concepts mentioned\n5. **Save raw source** for provenance (see Raw Source Preservation below)\n6. Analyze for the user: don't just summarize. What's interesting given what you\n   know about them? Flag connections, contradictions, content opportunities.\n\n**Write to:** appropriate directory per filing rules (about a person -> `people\u002F`,\nabout a company -> `companies\u002F`, reusable framework -> `concepts\u002F`, raw data -> `sources\u002F`)\n\n### Videos & Podcasts\n\n**Input:** URL (YouTube, podcast, etc.) or local audio\u002Fvideo file.\n\n**Process:**\n1. Get transcript -- speaker-diarized if possible (services like Diarize.io provide\n   speaker-labeled, word-level timing)\n2. **Save raw transcript** (both JSON and human-readable TXT)\n3. Analyze: executive summary, key ideas, key quotes with speaker attribution,\n   notable stories\u002Fanecdotes, people and companies mentioned\n4. Extract and cross-reference all entities mentioned\n5. **HARD RULE:** every video\u002Fpodcast brain page MUST link to the raw diarized\n   transcript. A page without transcript links is incomplete.\n\n**Write to:** `media\u002Fvideos\u002F` or `media\u002Fpodcasts\u002F` with back-links to all entities.\n\n**Quality bar:**\n- Compelling headline (not \"This video discusses...\")\n- Executive summary that makes you want to watch\u002Flisten\n- Key Ideas as actual insights, not topic labels\n- Verbatim quotes with real speaker names (not \"speaker_0\")\n- All entities extracted with context and back-linked\n\n### PDFs & Documents\n\n**Input:** File path or URL.\n\n**Process:**\n1. Extract text (OCR if scanned\u002Fimage PDF)\n2. **Save raw source** for provenance\n3. Summarize: executive summary + key sections + notable data\n4. Extract entities\n5. Cross-reference from entity pages\n\n**Write to:** per filing rules (file by primary subject, not format).\n\n### Screenshots & Images\n\n**Input:** Image file.\n\n**Process:**\n1. Analyze content (OCR for text-heavy images, description for photos)\n2. If tweet screenshot: extract text, author, date, route to social media workflow\n3. If article screenshot: extract text, route to article workflow\n4. If data\u002Fchart: extract data points, describe findings\n\n**Write to:** depends on content -- route to the appropriate workflow above.\n\n### Meeting Transcripts\n\n**Input:** Transcript from meeting recording service, or manual notes.\n\n**Process:**\n1. Pull full transcript (source of truth -- AI summaries are medium-low trust)\n2. **Save raw transcript** for provenance\n3. Write meeting page with YOUR analysis above the line, raw transcript below\n4. **Entity propagation (MANDATORY):** for each attendee and company discussed:\n   - Update their brain page State section if new info surfaced\n   - Append to their Timeline with link to the meeting page\n   - Create page if person\u002Fcompany is notable and has no page yet\n5. A meeting is NOT fully ingested until all entity pages are updated\n\n**Write to:** `meetings\u002FYYYY-MM-DD-short-description.md`\n\n**What makes a good meeting page:**\n- Reveals the real crux, not a bullet dump\n- Connects to existing brain pages (people, companies, deals)\n- Flags what changed (status, decisions, new info)\n- Names tension or what was left unsaid\n- Captures actual dynamic, not performative summary\n\n### Social Media Content\n\n**Input:** Tweet, thread, or social media post.\n\n**Process:**\n1. Fetch full content (thread, quote tweets, context)\n2. If images present: OCR via vision model for full text extraction\n3. Summarize: what's being said, why it matters, who's involved\n4. Extract entities and update brain pages\n5. Include direct link to the original post (MANDATORY for citations)\n\n**Write to:** `media\u002Fx\u002F` for daily aggregation, or entity-specific directories\nif the post is primarily about a person\u002Fcompany.\n\n## Raw Source Preservation\n\nEvery ingested item must have its raw source preserved for provenance.\n\n**Use `gbrain files upload-raw` for automatic size routing:**\n```bash\ngbrain files upload-raw \u003Cfile> --page \u003Cpage-slug> --type \u003Ctype>\n```\n\n- **\u003C 100 MB text\u002FPDF**: stays in git (brain repo `.raw\u002F` sidecar directories)\n- **>= 100 MB OR media** (video, audio, images): uploaded to cloud storage\n  via TUS resumable upload, `.redirect.yaml` pointer left in the brain repo\n\nThe `.redirect.yaml` pointer format:\n```yaml\ntarget: supabase:\u002F\u002Fbrain-files\u002Fpage-slug\u002Ffilename.mp4\nbucket: brain-files\nstorage_path: page-slug\u002Ffilename.mp4\nsize: 524288000\nsize_human: 500 MB\nhash: sha256:abc123...\nmime: video\u002Fmp4\nuploaded: 2026-04-11T...\ntype: transcript\n```\n\n**Accessing stored files:**\n- `gbrain files signed-url \u003Cstorage-path>` -- generate 1-hour signed URL for viewing\u002Fsharing\n- `gbrain files restore \u003Cdir>` -- download back to local from cloud storage\n\nUse `put_raw_data` in gbrain to store raw API responses and metadata (JSON, not binary).\n\n## Test Before Bulk\n\nWhen processing multiple items (batch video ingestion, bulk meeting processing, etc.):\n\n1. **Test on 3-5 items first.** Run in test mode if available.\n2. **Read the actual output.** Is the quality good? Are titles compelling (not\n   \"This video discusses...\")? Are entities extracted and back-linked? Is the\n   format clean?\n3. **Fix what's wrong** in the approach\u002Fskill, not via one-off patches.\n4. **Only then: bulk execute** with throttling, commits every 5-10 items.\n\nThe marginal cost of testing 3 items first is near zero. The cost of cleaning\nup 100 bad pages is enormous.\n\n## Quality Rules\n\n- Executive summary in compiled_truth must be updated, not just timeline appended\n- State section is REWRITTEN, not appended to. Current best understanding only.\n- Timeline entries are reverse-chronological (newest first)\n- Every person\u002Fcompany mentioned gets a page if notable (see filing rules)\n- Link types: knows, works_at, invested_in, founded, met_at, discussed\n- Source attribution: every timeline entry includes [Source: ...] citation\n- Back-links: every entity mention creates a back-link (Iron Law)\n- Filing: file by primary subject, not format or source (see filing rules)\n\n## Anti-Patterns\n\n- **Appending to State sections.** State is rewritten with the current best understanding on every update. Append-only State sections grow stale and contradictory.\n- **Ingesting without back-links.** An unlinked mention is a broken brain. Every entity mentioned must have a back-link from their page to the page mentioning them.\n- **Skipping raw source preservation.** Every ingested item must have its raw source preserved. A brain page without provenance is unverifiable.\n- **Bulk processing without sample test.** Test on 3-5 items first. Fix quality issues in the approach, not via one-off patches.\n- **Paraphrasing the user's original thinking.** The user's exact language IS the insight. Capture verbatim phrasing for ideas, theses, and frameworks.\n\n## Output Format\n\n```\nINGESTED: [title]\n==================\n\nPage: [slug]\nType: [person \u002F company \u002F meeting \u002F media \u002F concept]\nSource: [source description]\n\nEntities detected: N\n- [entity] -> [created \u002F updated] ([slug])\n\nBack-links created: N\nTimeline entries: N\nRaw source: [preserved at path \u002F uploaded to cloud]\n```\n\n## Tools Used\n\n- Read a page from gbrain (get_page)\n- Store\u002Fupdate a page in gbrain (put_page)\n- Add a timeline entry in gbrain (add_timeline_entry)\n- Link entities in gbrain (add_link)\n- List tags for a page (get_tags)\n- Tag a page in gbrain (add_tag)\n- Store raw data in gbrain (put_raw_data)\n- Check backlinks in gbrain (get_backlinks)\n",{"name":5,"tools":24,"mutating":31,"triggers":32,"writes_to":36,"description":7,"writes_pages":31},[25,26,27,28,29,30],"search","get_page","put_page","add_link","add_timeline_entry","sync_brain",true,[33,34,35],"ingest this","save this to brain","process this meeting",[37,38,39,40,41],"people\u002F","companies\u002F","concepts\u002F","meetings\u002F","sources\u002F","feat\u002Fbrain-first-convention","f3dace916c3845569f26904591b95baf00237bf8","skills\u002Fingest",0,"https:\u002F\u002Fgithub.com\u002Fltdrew\u002FAgent-brain-2","https:\u002F\u002Fgithub.com\u002Fltdrew","Account 2","2026-05-13 07:52:42",{"source":8,"skillName":5,"commands":51,"prompt":61,"zipAvailable":31},[52,55,58],{"tool":53,"command":54},"npx","npx skills add ltdrew\u002FAgent-brain-2 --skill ingest",{"tool":56,"command":57},"bunx","bunx skills add ltdrew\u002FAgent-brain-2 --skill ingest",{"tool":59,"command":60},"pnpm","pnpm dlx skills add ltdrew\u002FAgent-brain-2 --skill ingest","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fltdrew\u002FAgent-brain-2\u002Fblob\u002Ffeat\u002Fbrain-first-convention\u002Fskills\u002Fingest\u002FSKILL.md",[],[64,71,78,85,92,99],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M72SYQK7HQ98AEY8Z8DBT3C0","signal-detector","Always-on ambient signal capture for the OpenClaw reference fixture.","https:\u002F\u002Fgithub.com\u002Fltdrew\u002FAgent-brain-2\u002Fblob\u002Ffeat\u002Fbrain-first-convention\u002Ftest\u002Ffixtures\u002Fopenclaw-reference-minimal\u002Fskills\u002Fsignal-detector\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M72SYPHM4TDK6ZRV4NWAGC3D","query","Look up brain pages in the OpenClaw reference fixture.","https:\u002F\u002Fgithub.com\u002Fltdrew\u002FAgent-brain-2\u002Fblob\u002Ffeat\u002Fbrain-first-convention\u002Ftest\u002Ffixtures\u002Fopenclaw-reference-minimal\u002Fskills\u002Fquery\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M72SYN2J4BGSFS613D80AJQX","context-now","ALWAYS-ON time-sensitivity discipline for the OpenClaw reference fixture.","https:\u002F\u002Fgithub.com\u002Fltdrew\u002FAgent-brain-2\u002Fblob\u002Ffeat\u002Fbrain-first-convention\u002Ftest\u002Ffixtures\u002Fopenclaw-reference-minimal\u002Fskills\u002Fcontext-now\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M72SYKY67RCNH8VH9R2N0ZZV","brain-ops","Core read\u002Fwrite cycle for the OpenClaw reference fixture.","https:\u002F\u002Fgithub.com\u002Fltdrew\u002FAgent-brain-2\u002Fblob\u002Ffeat\u002Fbrain-first-convention\u002Ftest\u002Ffixtures\u002Fopenclaw-reference-minimal\u002Fskills\u002Fbrain-ops\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":19},"01M72SYHEMGTDRWSERJWZR0XE2","webhook-transforms","Generic framework for converting external events (SMS, meetings, social mentions)\ninto brain-ingestible signals. Define a transform function, register a webhook URL,\nand incoming events get processed through the brain pipeline.","https:\u002F\u002Fgithub.com\u002Fltdrew\u002FAgent-brain-2\u002Fblob\u002Ffeat\u002Fbrain-first-convention\u002Fskills\u002Fwebhook-transforms\u002FSKILL.md",[],[],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":19},"01M72SYEE2B8F47TN01CAGQ4JG","testing","Skill validation framework. Validates every skill has SKILL.md with frontmatter,\nevery reference exists, every env var is declared. The testing contract for the\nskill system itself.","https:\u002F\u002Fgithub.com\u002Fltdrew\u002FAgent-brain-2\u002Fblob\u002Ffeat\u002Fbrain-first-convention\u002Fskills\u002Ftesting\u002FSKILL.md",[],[]]