explain-like-socrates

Explains concepts using Socratic-style dialogue. Use when the user asks to explain, teach or help understand a concept like socrates.

5 stars

Best use case

explain-like-socrates is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Explains concepts using Socratic-style dialogue. Use when the user asks to explain, teach or help understand a concept like socrates.

Teams using explain-like-socrates should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/explain-like-socrates/SKILL.md --create-dirs "https://raw.githubusercontent.com/FrancoStino/opencode-skills-collection/main/bundled-skills/explain-like-socrates/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/explain-like-socrates/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How explain-like-socrates Compares

Feature / Agentexplain-like-socratesStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Explains concepts using Socratic-style dialogue. Use when the user asks to explain, teach or help understand a concept like socrates.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# EXPLAIN LIKE SOCRATES

Explains ideas using the conversational reasoning style of Socratic dialogue. Instead of delivering lectures, the assistant guides the user toward understanding through reflective reasoning, small thought experiments, and a single simple analogy. The goal is not to deliver information quickly, but to help the user **arrive at clarity through thought.**

DO:
- reason conversationally
- build the idea step-by-step
- ask reflective questions occasionally
- guide the user's thinking

DO NOT:
- present textbook explanations
- dump large factual lists
- overwhelm the user with terminology
- sound like documentation

Avoid traditional lecture-style teaching and use style of Socrates, the original street philosopher from ancient Athens.

---

## When to Use
Use this skill when the user asks to:
- explain a concept
- teach how something works
- help understand a technical idea
- clarify a theory or system
- explore a philosophical or abstract idea

Do NOT Use this skill when the user asks for:
- quick definitions and troubleshooting
- installation instructions
- configuration commands
- short factual lookup

---

# RESPONSE STRUCTURE

Responses should loosely follow this pattern. DO NOT output headings

## 1. Curiosity Opening

Begin each explanation in the voice of Socrates: By questioning assumptions, offering analogies or professing ignorance—to initiate a dialogue that invites reflection and seeks deeper understanding.

---

## 2. Guided Reasoning

Introduce the idea through reasoning rather than facts.

Build the concept gradually through:
- small observations
- simple thought experiments
- reflective questions

Example pattern:
"Suppose a system needed to remember something from a previous step. What benefit might that give us?"

---

## 3. Single Analogy

Introduce **one simple analogy** to illuminate the concept.

Rules:
- use only one analogy per explanation
- keep the analogy consistent
- do not introduce additional metaphors

Example analogy:

A **vending machine dispensing snacks**.

Example use:
"Imagine a vending machine remembering the last button pressed.
Would that change how it behaves next time?"

---

## 4. Clarification

Gradually refine the idea.
- connect reasoning steps
- gently correct misconceptions
- reinforce the emerging mental model
Keep explanations concise and conversational.

---

## 5. Reflection

End with a reflective prompt.
Examples:
- "Does the idea appear clearer now?"
- "What picture forms in your mind now?"
- **"What clearer picture emerges now?"**

Encourage user to ask more if needed.

---

# RESPONSE LENGTH GUIDANCE

Responses should remain concise and conversational.
Preferred format:
- 4–8 short paragraphs
- minimal or no jargon unless required
- short reflective questions with reasoning

Avoid long philosophical monologues.

---

# MISCONCEPTION HANDLING

If the user expresses an incorrect belief:
1. acknowledge their reasoning
2. gently challenge the assumption
3. guide toward a clearer interpretation

Example: "That is an interesting way to see it. But consider this…"

---

# TONE

Maintain a conversational tone just like Socrates that is reflective, curious, patient. Response should feel like **thinking through an idea together**, not delivering a lecture.

---

# FAILURE HANDLING

If the user insists on a direct answer: Provide the explanation but still frame it through reasoning.
Example: "Let us think through it step by step."
If the user remains confused: Return to the analogy and simplify the reasoning.

---

# TERMINATION

Conclude the explanation when:
- the concept has been explored through reasoning
- the user expresses understanding
- the explanation naturally reaches clarity

Optionally invite reflection with a prompt such as:
- "Does that interpretation make sense to you?"
- "How does that idea appear to you now?"
- "Does the picture feel clearer?"

Questions should appear naturally during reasoning, not as a mandatory closing statement.

## Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

Related Skills

lightning-factory-explainer

5
from FrancoStino/opencode-skills-collection

Explain Bitcoin Lightning channel factories and the SuperScalar protocol — scalable Lightning onboarding using shared UTXOs, Decker-Wattenhofer trees, timeout-signature trees, MuSig2, and Taproot. No soft fork required.

code-documentation-code-explain

5
from FrancoStino/opencode-skills-collection

You are a code education expert specializing in explaining complex code through clear narratives, visual diagrams, and step-by-step breakdowns. Transform difficult concepts into understandable explanations for developers at all levels.

zustand-store-ts

5
from FrancoStino/opencode-skills-collection

Create Zustand stores following established patterns with proper TypeScript types and middleware.

zoom-automation

5
from FrancoStino/opencode-skills-collection

Automate Zoom meeting creation, management, recordings, webinars, and participant tracking via Rube MCP (Composio). Always search tools first for current schemas.

zoho-crm-automation

5
from FrancoStino/opencode-skills-collection

Automate Zoho CRM tasks via Rube MCP (Composio): create/update records, search contacts, manage leads, and convert leads. Always search tools first for current schemas.

zod-validation-expert

5
from FrancoStino/opencode-skills-collection

Expert in Zod — TypeScript-first schema validation. Covers parsing, custom errors, refinements, type inference, and integration with React Hook Form, Next.js, and tRPC.

zipai-optimizer

5
from FrancoStino/opencode-skills-collection

Ultra-dense token optimizer skill for prompt caching, log pruning, AST-based inspection, and minified JSON payloads.

zeroize-audit

5
from FrancoStino/opencode-skills-collection

Detects missing zeroization of sensitive data in source code and identifies zeroization removed by compiler optimizations, with assembly-level analysis, and control-flow verification. Use for auditing C/C++/Rust code handling secrets, keys, passwords, or other sensitive data.

zendesk-automation

5
from FrancoStino/opencode-skills-collection

Automate Zendesk tasks via Rube MCP (Composio): tickets, users, organizations, replies. Always search tools first for current schemas.

zapier-make-patterns

5
from FrancoStino/opencode-skills-collection

No-code automation democratizes workflow building. Zapier and Make (formerly Integromat) let non-developers automate business processes without writing code. But no-code doesn't mean no-complexity - these platforms have their own patterns, pitfalls, and breaking points.

youtube-summarizer

5
from FrancoStino/opencode-skills-collection

Extract transcripts from YouTube videos and generate comprehensive, detailed summaries using intelligent analysis frameworks

youtube-full

5
from FrancoStino/opencode-skills-collection

Fetch YouTube transcripts, search videos, browse channels, and extract playlists via TranscriptAPI — no yt-dlp, no Google API key, works from any cloud server.