# Book Mirror

Take any book (EPUB/PDF), produce a personalized chapter-by-chapter analysis.

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

## Install

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

## Description

Take any book (EPUB/PDF), produce a personalized chapter-by-chapter analysis. Each chapter is preserved in detail (The Chapter) and mirrored back to the reader's actual life (The Mirror) using brain context. The mirror observes and resonates, a friend pointing out parallels, NOT a consultant rearranging the reader's life, NOT a therapist assigning homework. The reader decides what to do about it. Layout is a top-aligned HTML table or stacked sections, never a bare markdown pipe table (pipe tables center-misalign uneven columns). Output is a single brain page at media/books/<slug>-personalized.md plus an optional PDF via brain-pdf.

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

# book-mirror, Personalized Chapter-by-Chapter Book Analysis

> **Convention:** see [_brain-filing-rules.md](../_brain-filing-rules.md) for the
> sanctioned `media/<format>/<slug>` exception this skill files under.
>
> **Convention:** see [conventions/quality.md](../conventions/quality.md) for
> citation rules, back-link enforcement, and output quality bars.
>
> **Convention:** see [conventions/brain-first.md](../conventions/brain-first.md)
> for the lookup chain (brain → search → external) the context-gathering
> phase follows.

## What this does

Given a book (EPUB or PDF), produce a brain page where every chapter is
summarized in detail on one side ("The Chapter") and mirrored back to the
reader's actual life on the other ("The Mirror"), using their own words,
situations, people, and patterns from the brain. Output is a brain page at
`media/books/<slug>-personalized.md`.

This is NOT a generic book summary. The mirror is the value: it makes the
book read like a smart friend who happens to know the reader's life deeply
is pointing things out in the margins. The mirror's job is recognition, "that's exactly me", and then getting out of the way. If the user wants a
flat summary instead, route them to a different skill.

## Trust contract (read this before running)

book-mirror runs as a CLI command (`gbrain book-mirror`), NOT as a pure
markdown skill that the agent dispatches via tools. The CLI is the trusted
runtime; the skill is the orchestration prose around it.

What this means for the agent:

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