# Article Enrichment

Turns raw article text into structured pages with summaries and quotes.

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

## Install

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

## Description

Transform raw article text dumps in the brain into structured pages with executive summary, verbatim quotes, key insights, why-it-matters, and cross-references. Replaces walls-of-text with quotable, actionable brain pages.

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

# article-enrichment, From Raw Dumps to Useful Brain Pages

> **Convention:** see [conventions/quality.md](../conventions/quality.md) for
> citation rules, verbatim-quote requirements, and back-link enforcement.
>
> **Convention:** see [_brain-filing-rules.md](../_brain-filing-rules.md) for
> filing rules. Article pages live under `media/articles/` for raw ingest;
> personalized one-of-one synthesis output uses the sanctioned
> `media/articles/<slug>-personalized.md` exception.

## What this does

Takes an article brain page that's a wall of raw extracted text and rewrites
it as a structured page with:

- **Executive Summary**, 2-3 sentences, the ONE thing worth remembering
- **Why It Matters**, connects to the user's specific projects + interests
  (read from brain context, not assumed)
- **Quotable Lines**, 3-5 VERBATIM quotes worth referencing in essays
- **Key Insights**, actual insights, not topic labels
- **Surprising or Counterintuitive**, what makes this content unique
- **See Also**, standard markdown links to related brain pages

Raw source content is preserved in a collapsed `<details>` section so the
original is never lost.

## When to invoke

- New article page lands in the brain via media-ingest with `needs_enrichment: true`
- Existing article page is a wall of text under a `## Content` header with
  no synthesis
- User says a brain page is useless, boring, or a dump
- An LLM-judge brain-quality eval fails on quotability or actionability for
  an article page

## The pipeline

The rest: https://github.com/garrytan/gbrain/blob/HEAD/plugin/skills/article-enrichment/SKILL.md