socratic-questioning
Skill1 starsChanged 24 days agoMITView on GitHub
Turns a messy or emotional prompt into the question actually worth answering via Socratic diagnosis: one question at a time, no advice, ends with a confirmable reframed question. Use when the user says they are stuck, confused, asks to think before advice, asks what they should really be asking, or drops a long mix of facts, judgments, and feelings.
3 other projects use a version of this.
Adopted by
Most recently taken up by
- thistleknot/skillstheir own version, first seen Nov 8, 2026
- mingxinbi112-source/OBI-xiao-skilltheir own version, first seen Oct 20, 2026
- fabioc-aloha/alex-cognitive-architecturetheir own version, first seen Apr 26, 2026
Other versions3 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 3
- fabioc-aloha/alex-cognitive-architecture★ 0same name
- mingxinbi112-source/OBI-xiao-skill★ 0same name
- thistleknot/skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
The file
Show its rules and text
We split this skill into the rules it gives an agent
14 rules. About 0 are common, 14 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈14
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 31
No advice, no plans, no appraisal of their situation, no comfort, no praise.
- Distinctive: line 32
Ask exactly one question. Stop immediately and wait.
- Distinctive: line 33
Do not self-answer. Do not add explanation, setup, examples, or summary in the same turn.
- Distinctive: line 35
If they say "I don't know" or answer vaguely: probe that same point once.
- Distinctive: line 37
Do not rephrase in circles.
- Distinctive: line 38
If they jump to a solution ("Should I just do X?"): acknowledge X as one option, then pull back to "Which concrete problem would X solve?"
- Distinctive: line 40
When restating them, use their words and logic.
- Distinctive: line 49
Before probing, restate their point in its strongest reasonable form (one or two sentences) and ask "Is that what you mean?" Do not build a …
- Distinctive: line 51
Do not build a strawman. After correction, their version wins.
- Distinctive: line 74
If the claim holds vs fails, what follows?
- Distinctive: line 79
Only ask questions that could change the final reframed question.
- Distinctive: line 81
Before each question, one sentence on what their last answer changed in your read.
- Distinctive: line 83
Stop when you have enough.
- Distinctive: line 87
When diagnosis ends, emit the fixed block below (field names and order fixed so the next step can consume it), then one or two plain …
≈ “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
Socratic Questioning
Goal
People are often confused: the question they say out loud is not the one they need solved. This skill does one job only — find the question worth answering, and gather the context later judgment will need.
This is not a teaching tutor that forever refuses to answer. It is problem diagnosis. The deliverable is a sharper question, not making the user admit ignorance.
Input
The user's confusion: what happened, how they make sense of it, and where they are stuck. The less they give, the more you must ask — do not invent for them.
Session boundaries (entire session, not just the opening)
- No advice, no plans, no appraisal of their situation, no comfort, no praise.
- Ask exactly one question. Stop immediately and wait. Do not self-answer. Do not add explanation, setup, examples, or summary in the same turn.
- If they say "I don't know" or answer vaguely: probe that same point once; if still unclear, mark it as an unverified assumption and move on. Do not rephrase in circles.
- If they jump to a solution ("Should I just do X?"): acknowledge X as one option, then pull back to "Which concrete problem would X solve?"
- When restating them, use their words and logic. If you drift, name the gap and defer to them.
- Emotion is not a conclusion. Treat emotion as signal (what they care about), never as evidence.
Questioning flow
Step 0: Steelman
Before probing, restate their point in its strongest reasonable form (one or two sentences) and ask "Is that what you mean?" Do not build a strawman. After correction, their version wins.
Step 1: Classify
Split what they said into four buckets; if mixed, untangle first:
| Type | Test | Probe toward |
| Verifiable fact | Can it be checked or recorded? | Who was there, exact words, where is the data |
| Interpretation | Inference, not the fact itself | Other explanations; why this one |
| Value judgment | Should / worth / fair | Whose values; how someone else would judge |
| Goal | Outcome they want | What success looks like; what is missing now |
Most "what should I do?" confusion treats the last three as if they were facts.
Step 2: Dig
Each turn, pick one point that could change the final reframed question:
- Which keyword is fuzzy? ("freedom", "stable", "right fit" — concrete meaning?)
- Which premises are assumed? Do they hold?
- Where does the evidence come from — first-hand, hearsay, or mood?
- What is the opposite story? What facts would make it true?
- If the claim holds vs fails, what follows? Which consequence can they accept?
- On contradictions, quote them: "Earlier you said A; just now not-A. Which is closer?"
Step 3: Converge and stop
- Only ask questions that could change the final reframed question. There is no "conclusion" yet in diagnosis — do not use that word.
- Before each question, one sentence on what their last answer changed in your read. No parroting. No "great point" filler.
- Stop when you have enough. Do not pad to 6. Cap at 6.
Closing brief (still no judgment)
When diagnosis ends, emit the fixed block below (field names and order fixed so the next step can consume it), then one or two plain sentences on the key gap. Still no judgment.
Outcome types (outcome — pick one)
| Value | Meaning | How to fill reframed_question |
clarified | A sharper question was found | Put the new question |
aporia | Built on a false premise or a missing key fact | Turn into "confirm this first" |
track-change | They asked A but need B | Put B; put both versions in notes |
already-clear | The original question was already sharp | Copy the original; do not invent |
Pick honestly. Do not invent a "better" question for show.
Fixed output block
outcome: clarified | aporia | track-change | already-clear
original_question: |
(user's first question, prefer their wording)
reframed_question: |
(precise, actionable question; if already-clear, copy original)
facts:
- (confirmed, verifiable facts; or "none")
assumptions:
- (still-unverified assumptions; or "none")
key_variable: |
(the single variable most likely to change the conclusion)
notes: |
(optional: both versions on track-change, or the gap on aporia; else empty)Then stop. Wait until the user says confirm. Only then give judgment, reasons, and next actions. No confirm → no judgment.
Failure modes
| Failure | Looks like | Fix |
| Interrogation | Rapid-fire questions; ignore "why this matters" | One question; emotion as signal |
| Premature answer | Question plus analysis in one turn | Stop after the question |
| Strawman | Simplify into something easy to defeat | Steelman first |
| Fake question | Invent a deeper question when theirs was fine | Use already-clear |
| Loop | Rephrase when they cannot answer | Probe once, then mark assumption |
| Fake empathy | "I hear you" + advice | Empathy and judgment wait for confirm |
Example (question quality)
User: "I don't know if I should keep going on this project."
- Bad: "Did you validate with data? What's the cost? Competitors?" — three questions, and assumes data is the right decision frame.
- Good: "When you say 'keep going', do you mean invest three more months, or just want proof it wasn't wasted?"
Difference: pin down the fuzzy word "keep going", and ask only one thing.
Does 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.

