brain-ingest-gate
Pre-write quality gate for content entering the brain. No raw copies: a bare cp/mv into the brain repo is a bug. Before any new page lands, resolve named…
Read a book, article, transcript, or case study through the lens of a specific strategic problem you're facing. Produces an applied playbook that maps the source onto the problem and gives short/medium/long-term recommendations. NOT for general book summaries.
$ npx -y skills add garrytan/gbrain --skill strategic-reading --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/strategic-readingContext preview
The summary Claude sees to decide when to auto-load this skill.
Read a book, article, transcript, or case study through the lens of a specific strategic problem you're facing. Produces an applied playbook that maps the source onto the problem and gives short/medium/long-term recommendations. NOT for general book summaries.
name: strategic-reading version: 0.1.0 description: Read a book, article, transcript, or case study through the lens of a specific strategic problem you're facing. Produces an applied playbook that maps the source onto the problem and gives short/medium/long-term recommendations. NOT for general book summaries. triggers: - "strategic reading" - "read this through the lens of" - "apply this to my problem" - "what can I learn from this about" - "extract a playbook from" mutating: true writes_pages: true writes_to: - concepts/ - projects/ # Brain-first analyzer matches `web_fetch` in a diagram on line 106 # (illustrating fetch shape, not an API call) and `perplexity` in a # cross-reference to perplexity-research. The skill itself works on # uploaded source text + writes brain pages; it doesn't call external # APIs. Declarative opt-out. brain_first: exempt
> **Convention:** see [conventions/quality.md](../conventions/quality.md) for > citation rules (every recommendation cites the source) and back-link > enforcement. > > **Convention:** see [_brain-filing-rules.md](../_brain-filing-rules.md) — > output files by primary subject (concepts/ for general strategy, projects/ > for problem-tied playbooks).
Take a large text PLUS a specific strategic problem, produce analysis that maps the text's insights onto the problem. This is not book summarization. This is reading with a mission.
Where `book-mirror` personalizes a book to the reader's whole life, `strategic-reading` personalizes it to ONE current problem. Same shape (extract → analyze → mirror), different lens.
**Canonical example:** a power-dynamics history book read against a specific gatekeeper-vs-incumbent fight, producing a tactical analysis that maps the book's playbook onto the situation with counter-tactics and a short/medium/long-term playbook.
1. **Source text** — book (EPUB/PDF), article, transcript, historical case study, any large document. 2. **Strategic problem** — the specific situation to analyze through the lens of the text. The user describes this explicitly or it's obvious from context.
The brain page is the artifact. PDF is a rendering, never primary.
# [Source Title] — Applied to [Problem] > One-paragraph executive summary: how the source maps to the situation, > the key insight, the bottom line. ## The Core Parallel How the source's central dynamic maps onto the user's situation. ## Chapter / Section Triage For each major section of the source: - 2-3 sentence summary of what it says - Relevance to the problem: HIGH / MEDIUM / LOW - One directly applicable quote (if any) ## The Source's Playbook The author's framework, tactics, or strategies — organized as: - What the protagonist DID (tactics) - What WORKED and why - What FAILED and why - What OPPONENTS did that was effective ## Counter-Tactics Specific moves from the source that map to the user's situation: - What to DO (with source evidence) - What to AVOID (with source evidence) - What to WATCH FOR (warning signs from the source) ## Applied Playbook The synthesis — actionable recommendations: - **Short-term** (this week / this month) - **Medium-term** (this quarter) - **Long-term** (this year+) ## Key Quotes Direct quotes from the source that are devastatingly relevant. Maximum 5-10. Quality over quantity. ## See Also Links to relevant brain pages (related concepts, related projects).
Phase 1: Ingest the source ├── EPUB: extract chapters via BeautifulSoup (see book-mirror SKILL.md │ for the extraction pipeline) ├── PDF: pdftotext -layout ├── Article: web_fetch └── Identify Table of Contents and total size. Phase 2: Triage chapters ├── Read first 2000 chars of each chapter. ├── Classify relevance to the problem (HIGH / MEDIUM / LOW). └── HIGH chapters get full reads. MEDIUM partial. LOW skipped. Phase 3: Deep read HIGH chapters ├── Tactics and strategies used. ├── Power dynamics and how they shifted. ├── Specific quotes that map to the problem. └── Moments where the protagonist's approach succeeded or failed. Phase 4: Synthesize ├── Map source insights onto the specific problem. ├── Build the playbook (do / avoid / watch for). ├── Generate short/medium/long-term recommendations. └── Select the most devastating quotes. Phase 5: Write and deliver ├── Write the brain page at the right location: │ • If problem-specific: projects/<slug>/playbook.md │ • If general strategy: concepts/<slug>.md ├── put_page via the standard CLI flow. └── Optional: render to PDF via skills/brain-pdf.
the mayor" — say "go direct to the mayor, because when the protagonist refused to be intimidated by a resignation threat (Ch 48), the bluff that worked on five mayors finally failed."
weight than paraphrase.
this, avoid that, watch for this."
know what to do tomorrow AND what to do this year.
personalized analysis) for general summaries.
information about a topic.
only strategic application.
problem)
for fresh data
This skill guarantees:
Give the agent you already use a memory you control. GBrain stores explicit facts with their sources, supports corrections and withdrawal, and makes the same memory available across your agents.
Repo: garrytan/gbrain
Pre-write quality gate for content entering the brain. No raw copies: a bare cp/mv into the brain repo is a bug. Before any new page lands, resolve named…
When you report a brain page to the user — created, edited, committed, or relayed from a subagent — a working link is part of the deliverable, in the SAME…
Brain knowledge base operations. The core read/write cycle: brain-first lookup, read-enrich-write loop, source attribution, ambient enrichment, back-linking.…
Deduplicate and synthesize raw concept stubs into a tiered intellectual map (T1 Canon to T4 Riff), tracing idea evolution across sources over time. Transforms…
Token-hygiene audit of the always-loaded context stack — CLAUDE.md, AGENTS.md, auto-memory MEMORY.md, and the bootstrap-rendered identity files (SOUL.md,…
When the user corrects a factual error, root-cause it immediately. Don't just note the correction — trace the error to its source, fix the source, and prevent…