agentleFS
Yuki-CC1006Yuki-CC1006/socratic-questioning/SKILL.md

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

  • Other versions3 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 3

    1. fabioc-aloha/alex-cognitive-architecture★ 0same name
    2. mingxinbi112-source/OBI-xiao-skill★ 0same name
    3. 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
  1. Distinctive:

    No advice, no plans, no appraisal of their situation, no comfort, no praise.

    line 31
  2. Distinctive:

    Ask exactly one question. Stop immediately and wait.

    line 32
  3. Distinctive:

    Do not self-answer. Do not add explanation, setup, examples, or summary in the same turn.

    line 33
  4. Distinctive:

    If they say "I don't know" or answer vaguely: probe that same point once.

    line 35
  5. Distinctive:

    Do not rephrase in circles.

    line 37
  6. Distinctive:

    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?"

    line 38
  7. Distinctive:

    When restating them, use their words and logic.

    line 40
  8. Distinctive:

    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 …

    line 49
  9. Distinctive:

    Do not build a strawman. After correction, their version wins.

    line 51
  10. Distinctive:

    If the claim holds vs fails, what follows?

    line 74
  11. Distinctive:

    Only ask questions that could change the final reframed question.

    line 79
  12. Distinctive:

    Before each question, one sentence on what their last answer changed in your read.

    line 81
  13. Distinctive:

    Stop when you have enough.

    line 83
  14. Distinctive:

    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 …

    line 87

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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:

TypeTestProbe toward
Verifiable factCan it be checked or recorded?Who was there, exact words, where is the data
InterpretationInference, not the fact itselfOther explanations; why this one
Value judgmentShould / worth / fairWhose values; how someone else would judge
GoalOutcome they wantWhat 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)

ValueMeaningHow to fill reframed_question
clarifiedA sharper question was foundPut the new question
aporiaBuilt on a false premise or a missing key factTurn into "confirm this first"
track-changeThey asked A but need BPut B; put both versions in notes
already-clearThe original question was already sharpCopy 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

FailureLooks likeFix
InterrogationRapid-fire questions; ignore "why this matters"One question; emotion as signal
Premature answerQuestion plus analysis in one turnStop after the question
StrawmanSimplify into something easy to defeatSteelman first
Fake questionInvent a deeper question when theirs was fineUse already-clear
LoopRephrase when they cannot answerProbe once, then mark assumption
Fake empathy"I hear you" + adviceEmpathy 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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.