/enrich

name: enrich
version: 1.0.0
description: |
  Enrich brain pages with tiered enrichment protocol. Creates and updates
  person/company pages with compiled truth, timeline, and cross-links.
  Use when a new entity is mentioned or an existing page needs updating.
triggers:
  - "enrich"
  - "create person page"
  - "update company page"
  - "who is this person"
  - "look up this company"
tools:
  - get_page
  - put_page
  - search
  - query
  - add_link
  - add_timeline_entry
  - get_backlinks
mutating: true
writes_pages: true
writes_to:
  - people/
  - companies/

Enrich Skill

Enrich person and company pages from external sources. Scale effort to importance.

Contract

This skill guarantees:

• Every enriched page has compiled truth (State section) with inline citations
• Every enriched page has a timeline with dated entries
• Back-links are created bidirectionally
• Tiered enrichment: Tier 1 (full), Tier 2 (medium), Tier 3 (minimal) based on notability
• No stubs: every new page has meaningful content from web search or existing brain context

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

> **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 FROM that entity's page TO the page mentioning them. An unlinked mention is a broken brain. See `skills/_brain-filing-rules.md` for format.

Philosophy

A brain page should read like an intelligence dossier, not a LinkedIn scrape. Facts are table stakes. Texture is the value -- what do they believe, what are they building, what makes them tick, where are they headed.

Citation Requirements (MANDATORY)

> **Convention:** see `skills/conventions/quality.md` for citation formats and source precedence.

When sources conflict, note the contradiction with both citations.

When To Enrich

Primary triggers

• User mentions an entity in conversation
• Entity appears in a meeting transcript or email
• New contact appears with significant context
• Entity makes news or has a major event
• Any ingest pipeline encounters a notable entity

Do NOT enrich

• Random mentions with no relationship signal
• Bot/spam accounts
• Entities with no substantive connection to the user's work
• Same page enriched within the past week (unless new signal warrants it)

Enrichment Tiers

Scale enrichment to importance. Don't waste API calls on low-value entities.

| Tier | Who | Effort | Sources | |------|-----|--------|---------| | 1 (key) | Inner circle, close collaborators, key contacts | Full pipeline | All available APIs + deep web research | | 2 (notable) | Occasional interactions, industry figures | Moderate | Web research + social + brain cross-ref | | 3 (minor) | Worth tracking, not critical | Light | Brain cross-ref + social lookup if handle known |

The Enrichment Protocol (7 Steps)

Step 1: Identify entities

Extract people, companies, concepts from the incoming signal.

Step 2: Check brain state

For each entity:

• `gbrain search "name"` -- does a page already exist?
• **If yes:** UPDATE path (add new signal, update compiled truth if material)
• **If no:** CREATE path (check notability gate first, then create)

Step 3: Extract signal from source

Don't just capture facts. Capture texture:

| Signal Type | What to Extract | |-------------|----------------| | Opinions, beliefs | What They Believe section | | Current projects, features shipped | What They're Building section | | Ambition, career arc, motivation | What Motivates Them section | | Topics they return to obsessively | Hobby Horses section | | Who they amplify, argue with, respect | Network / Relationships | | Ascending, plateauing, pivoting? | Trajectory section | | Role, company, funding, location | State section (hard facts) |

Step 4: External data source lookups

Priority order -- stop when you have enough signal for the entity's tier.

**4a. Brain cross-reference (always, all tiers)**

• `gbrain search "name"` and `gbrain query "what do we know about name"`
• Check related pages: company pages for person enrichment and vice versa
• This is free and often the richest source

**4b. Web research (Tier 1 and 2)**

• Use Perplexity, Brave Search, Exa, or equivalent web research tool
• **Key pattern:** Send existing brain knowledge as context so the search

returns DELTA (what's new vs what you already know), not a rehash

• Opus-class models for Tier 1 deep research, lighter models for Tier 2

**4c. Social media lookup (all tiers when handle known)**

• Pull recent posts/tweets for tone, interests, current focus
• Social media is the highest-texture signal for what someone actually thinks

**4d. People enrichment APIs (Tier 1)**

• LinkedIn data, career history, connections, education

**4e. Company enrichment APIs (Tier 1)**

• Company data, financials, headcount, key hires, recent news

| Data Need | Example Sources | Tier | |-----------|----------------|------| | Web research | Perplexity, Brave, Exa | 1-2 | | LinkedIn / career | Crustdata, Proxycurl, People Data Labs | 1 | | Career history | Happenstance, LinkedIn | 1 | | Funding / company data | Crunchbase, PitchBook, Clearbit | 1 | | Social media | Platform APIs, web scraping | 1-3 | | Meeting history | Calendar/meeting transcript tools | 1-2 |

Step 5: Save raw data (preserves provenance)

Store raw API responses via `put_raw_data` in gbrain:

{
  "source": "crustdata",
  "fetched_at": "2026-04-11T...",
  "query": "jane doe",
  "data": { ... }
}

Raw data preserves provenance. If the compiled truth is ever questioned, the raw data shows exactly what the API returned.

Step 6: Write to brain

CREATE path

1. Check notability gate (see `skills/_brain-filing-rules.md`) 2. Resolve the entity's type, directory and subtype from the ACTIVE schema pack, never from the templates below: follow `skills/brain-taxonomist/SKILL.md` (`gbrain schema sh