explain-like-socrates

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

38 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/lingxling/awesome-skills-cn/main/antigravity-awesome-skills/plugins/antigravity-awesome-skills-claude/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

38
from lingxling/awesome-skills-cn

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

38
from lingxling/awesome-skills-cn

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.

find-skills

38
from lingxling/awesome-skills-cn

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

vercel-cli-with-tokens

38
from lingxling/awesome-skills-cn

Deploy and manage projects on Vercel using token-based authentication. Use when working with Vercel CLI using access tokens rather than interactive login — e.g. "deploy to vercel", "set up vercel", "add environment variables to vercel".

vercel-react-view-transitions

38
from lingxling/awesome-skills-cn

Guide for implementing smooth, native-feeling animations using React's View Transition API (`<ViewTransition>` component, `addTransitionType`, and CSS view transition pseudo-elements). Use this skill whenever the user wants to add page transitions, animate route changes, create shared element animations, animate enter/exit of components, animate list reorder, implement directional (forward/back) navigation animations, or integrate view transitions in Next.js. Also use when the user mentions view transitions, `startViewTransition`, `ViewTransition`, transition types, or asks about animating between UI states in React without third-party animation libraries.

vercel-react-native-skills

38
from lingxling/awesome-skills-cn

React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementing animations, or working with native modules. Triggers on tasks involving React Native, Expo, mobile performance, or native platform APIs.

deploy-to-vercel

38
from lingxling/awesome-skills-cn

Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".

vercel-composition-patterns

38
from lingxling/awesome-skills-cn

React composition patterns that scale. Use when refactoring components with boolean prop proliferation, building flexible component libraries, or designing reusable APIs. Triggers on tasks involving compound components, render props, context providers, or component architecture. Includes React 19 API changes.

vercel-deploy

38
from lingxling/awesome-skills-cn

Deploy applications and websites to Vercel. Use this skill when the user requests deployment actions such as "Deploy my app", "Deploy this to production", "Create a preview deployment", "Deploy and give me the link", or "Push this live". No authentication required - returns preview URL and claimable deployment link.

ckm:ui-styling

38
from lingxling/awesome-skills-cn

Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs. Use when building user interfaces, implementing design systems, creating responsive layouts, adding accessible components (dialogs, dropdowns, forms, tables), customizing themes and colors, implementing dark mode, generating visual designs and posters, or establishing consistent styling patterns across applications.

ckm:design

38
from lingxling/awesome-skills-cn

Comprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG, Gemini 3.1 Pro), social photos (HTML→screenshot, multi-platform). Actions: design logo, create CIP, generate mockups, build slides, design banner, generate icon, create social photos, social media images, brand identity, design system. Platforms: Facebook, Twitter, LinkedIn, YouTube, Instagram, Pinterest, TikTok, Threads, Google Ads.

ckm:design-system

38
from lingxling/awesome-skills-cn

Token architecture, component specifications, and slide generation. Three-layer tokens (primitive→semantic→component), CSS variables, spacing/typography scales, component specs, strategic slide creation. Use for design tokens, systematic design, brand-compliant presentations.