insight-interview
Skill109 starsChanged 37 days agoMITView on GitHub
KB-grounded Socratic interview. Searches existing notes on a topic, then runs a one-question-at-a-time dialogue to surface, sharpen, and extract your own thinking. Ends by running extract-insights on the full conversation transcript.
In this repository61 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- adviseSkill
- ai-crystallizeSkill
- analyze-kbSkill
- auto-discoverySkill
- benchmark-memorySkill
- brain-mergeSkill
- changelog-protocolSkill
- coherence-sweepSkill
- compute-lifecycleSkill
- create-articleSkill
- create-explanatory-imageSkill
- decideSkill
- deep-researchSkill
- detect-tensionsSkill
- dialecticSkill
- domain-watchSkill
- elicitation-techniquesSkill
- epistemic-classificationSkill
- epub-chapter-extractorSkill
- extract-document-insightsSkill
- extract-insightsSkill
- find-connectionsSkill
- first-runSkill
- get-perspective-onSkill
- get-youtube-transcriptSkill
- git-commit-pushSkill
- graduate-insightsSkill
- incubation-loopSkill
- ingest-sourceSkill
- insight-capture-formatSkill
- integrate-recent-notesSkill
- learn-new-thingsSkill
- manage-reference-dataSkill
- manage-thinking-topicsSkill
- manage-watching-domainsSkill
- multi-format-book-extractorSkill
- nano-banana-image-generatorSkill
- propagate-changeSkill
- quick-searchSkill
- reasoning-checksSkill
- recallSkill
- ref-auditSkill
- ref-bridgeSkill
- ref-ingestSkill
- ref-querySkill
- ref-reconcileSkill
- ref-refreshSkill
- refresh-indexSkill
- ref-supersedeSkill
- scheduled-runSkill
- scope-mountSkill
- search-vaultSkill
- self-diagnosticSkill
- start-hereSkill
- synthesize-insightsSkill
- talkSkill
- test-memory-systemSkill
- think-about-itSkill
- update-changelogSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
12 rules. About 0 are common, 11 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈11
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 16
Not to summarize a topic. Not to explain research.
- Distinctive: line 33
Run semantic search on the topic using Local Brain Search:
- Distinctive: line 45
Read the top 8-10 results.
- Distinctive: line 54
Before asking anything, internally map 5-7 candidate question zones:
- Distinctive: line 76
One question only: Wait for the response.
- Distinctive: line 80
After each response, decide:
- Distinctive: line 105
Before ending, ask one final open question:
- Distinctive: line 113
Create a transcript file combining the full dialogue:
- Very specific: line 151
Create or update notes in Brain/AI Extracted Notes/
- Distinctive: line 158
One question at a time: Always. No lists of questions.
- Distinctive: line 160
Don't summarize back every time: Only reflect back when something crystallized - and then be precise.
- Distinctive: line 161
Follow energy: If a response is animated or detailed, stay in that thread.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Insight Interview
A Socratic dialogue grounded in your own knowledge base. It finds what you already think, then probes the edges - gaps, underdeveloped claims, contradictions, missing connections - one question at a time. Your responses feed directly into the vault at the end.
Purpose
Not to summarize a topic. Not to explain research. To find out what you actually think - and make that thinking precise enough to live in the knowledge base.
The KB is the context, not the content. Every question is anchored in a note you already wrote.
State Dependencies
| Source | Location | Read | Write |
| Existing notes | Brain/ via Local Brain Search | ✓ | |
| Permanent notes | Brain/02-Permanent/ | ✓ | |
| Dialogue transcript | resources/insight-interview-[slug]-[date].md | ✓ | |
| Extracted insights | Brain/AI Extracted Notes/ | ✓ (via extract-insights) |
Process
Step 1: Search the KB
Run semantic search on the topic using Local Brain Search:
cd resources/local-brain-search && python search.py "[topic]" --top_k 15 --mode spreadingAlso run a keyword grep across permanent notes:
grep -rl "[topic keywords]" Brain/02-Permanent/ Brain/AI\ Extracted\ Notes/ | head -20Read the top 8-10 results. Understand:
- What the user already believes about this topic
- Which claims are well-developed vs. sketched
- Where tensions or contradictions exist between notes
- What connections are asserted but not fully argued
- What's notably absent (a gap where you'd expect a note)
Step 2: Map the Frontier
Before asking anything, internally map 5-7 candidate question zones:
- Existing claim to probe: A strong assertion in a note that could be sharpened or challenged
- Gap: An angle you'd expect him to have thought about but haven't found
- Contradiction: Two notes that pull in opposite directions
- Connection: A note that seems related to another topic he knows well - does he see it?
- So-what: A well-documented insight with no clear practical implication
- Origin: A belief stated as fact - where did it come from?
- Frontier: The newest or most uncertain note - what's unresolved?
Prioritize. You'll likely cover 5-8 of these in a session.
Step 3: Open the Dialogue
Introduce with one sentence of context showing what you found in the KB, then ask the first question. Keep it grounded - reference the specific note or claim:
"You have a note [[X]] where you say '[direct quote or paraphrase]'. Given [new angle / related note / recent development], do you still hold that? Or has your view shifted?"
OR for a gap:
"You have strong thinking on [A] and [B], but I didn't find anything on [C] - which sits right between them. What's your actual take?"
One question only. Wait for the response.
Step 4: Dialogue Loop
After each response, decide:
- Deepen this thread: The answer opened something - follow it (ask for evidence, for the counterargument, for the implication)
- Mark and move: Useful answer, but another zone is more promising - transition to the next question
- Capture and close: The response crystallized something - reflect it back precisely, confirm it's right, then move on
Question types to cycle through (from elicitation-techniques):
| Type | When to use | Example |
| Clarification | Vague or assumed term | "What exactly do you mean by [X] here?" |
| Assumption excavation | Strong claim stated as fact | "What would have to be false for this not to hold?" |
| Counterargument | One-sided note | "What's the strongest case against this?" |
| Connection probe | Two related notes not linked | "Does this relate to your thinking on [Y]?" |
| Implication | Well-documented insight with no so-what | "If this is true, what changes?" |
| Origin | Belief with no cited source | "Where does this come from? Experience, reading, both?" |
| Precision | Fuzzy claim | "How strong is this? Always? Sometimes? Under what conditions?" |
Aim for 6-10 exchanges. Stop when:
- You've covered the main frontier zones
- The conversation is producing diminishing returns
- The user says "done", "enough", or similar
Step 5: Close
Before ending, ask one final open question:
"Is there anything on this topic that you think is important but we haven't touched?"
Give space for any loose threads.
Step 6: Save Transcript
Create a transcript file combining the full dialogue:
resources/insight-interview-[topic-slug]-[YYYY-MM-DD].mdFormat:
# Insight Interview: [Topic]
**Date**: YYYY-MM-DD
**KB notes consulted**: [list of note titles]
**Questions asked**: [count]
---
**[Question 1]**
[Response]
**[Question 2]**
[Response]
...
---
*Raw transcript for extract-insights processing*Step 7: Run Extract-Insights
Invoke the extract-insights skill on the transcript:
/extract-insights resources/insight-interview-[topic-slug]-[YYYY-MM-DD].mdThis will:
- Deduplicate against existing KB
- Extract new insights in your voice
- Create or update notes in
Brain/AI Extracted Notes/ - Log changes in
Brain/05-Meta/Changelogs/
Report what was created or updated.
Dialogue Principles
- One question at a time. Always. No lists of questions.
- Show your work. Reference the specific note you're drawing from. This makes it feel like a conversation with someone who read your stuff, not a generic interview.
- Don't summarize back every time. Only reflect back when something crystallized - and then be precise.
- Follow energy. If a response is animated or detailed, stay in that thread.
- Don't lead. The question opens space; it doesn't suggest the answer.
- Tolerate "I don't know". That's a real answer. Ask what would need to be true to know.
Outputs
- Dialogue transcript:
resources/insight-interview-[slug]-[date].md - Extracted insight notes:
Brain/AI Extracted Notes/ - Changelog entry:
Brain/05-Meta/Changelogs/
Usage
/insight-interview self-improving agents
/insight-interview dopamine and motivation
/insight-interview the folder paradigmDoes it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

