Skill.md files: teach Claude once, not every chat.

• SKILL.md

---
name: skillpack-check
description: Run `gbrain skillpack-check` to produce an agent-readable JSON health report
for the gbrain install. Wraps `gbrain doctor` + `gbrain apply-migrations
--list` so a host agent (your OpenClaw's morning-briefing, any OpenClaw cron)
can see at a glance whether the skillpack needs attention.

Use when the user asks "is gbrain healthy?", when a cron fires a morning
check, or proactively when something seems off (jobs not running, brain
not updating, autopilot silent).
---

• SKILL.md

---
name: smoke-test
description: Health smoke tests + auto-fix for gbrain installs (and OpenClaw services
when present). Run after machine/container restarts or whenever something
seems broken. Tests critical services, auto-fixes bounded local issues,
and reports worker topology without starting daemons. Extensible via
user-defined test scripts in ~/.gbrain/smoke-tests.d/*.sh.
---

• SKILL.md

---
name: soul-audit
description: Re-run or deepen the agent's identity interview. Drives the SHARED bootstrap
answer bank (state/interview.json) via `gbrain bootstrap interview
--set/--show/--confirm`, then re-renders the identity files with
`gbrain bootstrap render --only <FILE> --force`. One answer store, two
surfaces: first-boot bootstrap and this re-run skill write the same bank, so
an updated answer flows into SOUL.md, USER.md, ACCESS_POLICY.md, and
HEARTBEAT.md without hand-editing rendered files. Every answer is the user's
own words — never invented.
---

• SKILL.md

---
name: two-tier-extraction
description: Tiered LLM extraction pattern for large corpus processing (email archives,
document dumps, transcript libraries). A utility-tier model triages and
classifies at speed; the reasoning tier does the default deep read; the
deep tier is the escalation for the highest-value content. Prevents
spending deep-tier money on noise while ensuring the important content
gets the best eyes. A deterministic privacy wall runs before any LLM call.
---

• SKILL.md

---
name: webhook-transforms
description: Generic framework for converting external events (SMS, meetings, social mentions)
into brain-ingestible signals. Define a transform function, register a webhook URL,
and incoming events get processed through the brain pipeline.
---

• SKILL.md

---
name: voice-persona-mars
description: Route to Mars (introspective thought partner / demo showman voice persona). Used when the operator wants depth, meaning, or impressive social demos rather than logistics. Mars handles SOLO mode (philosophy, presence, patterns) and DEMO mode (tool-driven showmanship) automatically.
---

• SKILL.md

---
name: voice-persona-venus
description: Route to Venus (sharp executive-assistant voice persona). Used for logistics — calendar, tasks, recent messages, brain lookups — at sub-second phone-call latency. The default voice persona unless DEFAULT_PERSONA=mars is set.
---

• SKILL.md

---
name: retrieval-reflex
description: When/what to retrieve — open the brain page for a salient entity before answering from memory.
---

• SKILL.md

---
name: academic-verify
description: Verify a research claim or academic citation by tracing it through publication → methodology → raw data → independent replication. Routes through perplexity-research for the actual web lookup, then formats results as a citation-checked brain page. Use when a book/article/conversation cites a study and you want to confirm the claim is real, replicated, and accurately characterized.
---

• SKILL.md

---
name: archive-crawler
description: Universal archivist for personal file archives (Dropbox/B2/Gmail-takeout/local-mount/hard-drive-dump). Filters for high-value content (the user's own writing, ideas, relationships) and surfaces it interactively. REFUSES TO RUN without an explicit gbrain.yml `archive-crawler.scan_paths:` allow-list.
---

• SKILL.md

---
name: article-enrichment
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

---
name: ask-user
description: Reusable pattern for presenting the user with explicit choices and gating
execution until they respond. Used by other skills when a decision point
requires human input before proceeding. Platform-agnostic — works on
Telegram (inline buttons), Discord, CLI, or any agent with a message tool.
---

• SKILL.md

---
name: book-mirror
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

---
name: brain-ingest-gate
description: 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 entities registry-first (a vector score is a floor for prose, never a gate for named things), then run the read-the-top-hit dedup decision tree (clear-dup / plausible-dup / clear). Owns dedup; delegates enrichment to the shipped ingestion skills. Routing convention, not an operation-boundary enforcement.
---

• SKILL.md

---
name: brain-link-discipline
description: 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 message. Derive the path mechanically (git ls-files --full-name), push
BEFORE linking, verify the link resolves when a hosted remote exists, and
degrade through a defined fallback chain when it doesn't. Inside brain
pages the rule inverts: relative links preserve the link graph; absolute
URLs are for chat deliverables only.
---

• SKILL.md

---
name: brain-ops
description: Brain knowledge base operations. The core read/write cycle: brain-first lookup,
read-enrich-write loop, source attribution, ambient enrichment, back-linking.
Read this before any brain interaction.
---

• SKILL.md

---
name: brain-pdf
description: Generate a publication-quality PDF from any brain page via the gstack make-pdf binary. Strips YAML frontmatter, sanitizes emoji, applies running headers and page numbers. Brain page is always the source of truth; PDF is a rendering.
---

• SKILL.md

---
name: brain-taxonomist
description: Filing gate for ALL brain writes. Consulted before creating any new
brain page to determine the correct path. Reads the ACTIVE schema pack
via `gbrain schema show --json` — no hardcoded directory table. Also
runs periodic taxonomy drift detection via `gbrain schema review-orphans`.
---

• SKILL.md

---
name: briefing
description: Compile daily briefing with meeting context, active deals, and citation tracking
---

• SKILL.md

---
name: bulk-ingestion
description: End-to-end discipline for turning any large data source (audio libraries,
email takeouts, document corpora, chat exports, API dumps) into brain pages
at scale. The lifecycle spine: SCHEMA → ACCESS → TRIAL → EVALUATE → IMPROVE
→ CODIFY → TEST → SKILLIFY → BULK → MONITOR. State is tracked in a durable
JSON manifest (see MANIFEST-PATTERN.md) so any crash, session boundary, or
subagent fan-out resumes from ground truth instead of memory.
---

• SKILL.md

---
name: capture
description: Save any thought or content into the brain via one CLI command. The single human-facing entrypoint that replaces "put_page vs commit-then-sync vs autopilot-wait" with one command that just works.
---

• SKILL.md

---
name: chat-connectors
description: Connect a ChatGPT or Claude account and sync its conversation history into the brain automatically. Cookie paste-in is the primary lane; sync is incremental (watermark + trailing-window gap-heal), and can run on a schedule via autopilot or host cron. Distinct from the export-file lane (that lives in conversation-archive) — this is the LIVE, account-connected, auto-scraping path.
---

• SKILL.md

---
name: citation-fixer
description: Audit and fix citation formatting across brain pages. Ensures every fact has
an inline [Source: ...] citation matching the standard format. Extended in
v0.25.1: scans for broken tweet/post references that lack actual URLs and
resolves them via the host's X / Twitter API integration.
---

• SKILL.md

---
name: citation-graph-ingest
description: Build a TYPED citation/reference graph over an ingested corpus — not just
embeddings. Flat similarity retrieval cannot tell you that document A
*overrules* B, *distinguishes* C, or *relies_on* D. This skill extracts every
inter-document reference, classifies the edge TYPE with LLM judgment, and
writes first-class typed edges via `gbrain link`, so `gbrain graph-query
--type` can walk the argument ("everything this brief relies on, minus
anything overruled since"). Every cite-heavy corpus is the same shape: law,
academic papers, patents, regulatory filings, a book's bibliography.
---