// Extract insights from external documents (research papers, books, articles). Spawns document-insight-extractor subagent. Requires session name.
| name | extract-document-insights |
| description | Extract insights from external documents (research papers, books, articles). Spawns document-insight-extractor subagent. Requires session name. |
| allowed-tools | ["Task"] |
| user-invocable | true |
| arg-description | <session name> <file path or content description> |
Extract insights from EXTERNAL documents with proper epistemic classification.
User-invocable wrapper that spawns the document-insight-extractor subagent to:
Brain/Document Insights/[session]/NOT for personal content - use /extract-insights for your conversations, transcripts.
/extract-document-insights "2025-02-21 Ancient Wisdom Research" /path/to/document.md
/extract-document-insights "AI Agent Papers" "the transcript above"
Session name is REQUIRED - describes the research session for organization.
Parse arguments to extract session name and source
Spawn document-insight-extractor subagent via Task tool with:
Task(
subagent_type="document-insight-extractor",
prompt="Extract insights from: [source] into session '[session-name]'. Follow your mandatory workflow - contextualize, classify epistemically, search duplicates, create notes, update changelog."
)
Report results - number of insights extracted, session folder path
Suggest insight interview - Present to user:
"[N] insights from [source] saved to
Brain/Document Insights/[session]/.Before these get indexed, consider running
/insight-interview [topic]to capture your own angles - where you agree, disagree, or see connections the research missed. Your responses save toBrain/AI Extracted Notes/and both sets will be available for the next connection discovery run.Run
/insight-interview [topic]to continue, or skip if you want to index these as-is."
Brain/Document Insights/[session]//insight-interview [topic] to layer in your personal perspectiveRun a full coherence sweep across the Brain Dependency Graph - computes staleness, lifecycle transitions, structural health, and generates a report
Compute lifecycle scores for all insight and framework notes - detect which notes are crystallizing or becoming generative
Autonomous research pipeline - discover, extract, and integrate cutting-edge insights into knowledge base
Detect productive contradictions between notes - high semantic similarity with opposing conclusions that represent synthesis opportunities
Autonomous perception layer - scans KB for new notes matching domain watch configs, checks gap resonance with the Thinking Registry, probes external signals via web search, and auto-activates HIGH/MEDIUM signals into the Thinking Registry for the incubation loop.
Extract the transcript from a YouTube video by URL or video ID. Use when the user shares a YouTube link and wants the transcript, captions, or text content of the video. Falls back automatically if the requested language isn't available.