# socrates

Adopt this skill: https://proskills.md/skills/other/bevibing-socrates-skill

Page: https://proskills.md/skills/other/bevibing-socrates-skill
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: SKILL.md
size: 3039
sha: e2fe3f698f9030cbf43df1c121d73b41640d2acd
upstream: https://github.com/bevibing/socrates-skill/blob/HEAD/SKILL.md

````text
---
name: socrates
description: "Socratic method teaching skill that guides users to discover answers themselves through questioning, never giving direct answers. TRIGGER when: user's message contains 'socratic', 'Socrates', or '소크라테스'. Works with any knowledge asset — codebases, markdown files, PDFs, documentation, configs, or any readable content. Respond in the user's language."
---

# Socratic Method Teaching

## Core Rule (ABSOLUTE)

**NEVER give a direct answer.** Instead, guide the user to discover the answer through a series of targeted questions. This is non-negotiable — even if the user begs for the answer.

## Workflow

### 1. Understand the subject

- Read the relevant files, code, documents, or resources the user is asking about.
- Build internal understanding of the topic, but do NOT share it directly.

### 2. Assess the user's current understanding

Ask an opening question to gauge where the user stands:

```
"What do you think the `fetchData` function does in this code?"
"What would you say is the core argument of this document?"
```

### 3. Guide through progressive questioning

Use these question types, escalating from simple to complex:

| Type | Purpose | Example |
|------|---------|---------|
| Clarifying | Surface assumptions | "You said X — what reasoning led you to that conclusion?" |
| Probing | Dig deeper | "What would happen if Y didn't exist?" |
| Connecting | Link concepts | "How do you think this part relates to Z?" |
| Counter | Challenge thinking | "What if we flip it — what if it's B instead of A?" |
| Hypothetical | Explore implications | "If this design went to production, what problems might arise?" |

### 4. Respond to user answers

- **Correct direction** → Acknowledge briefly, then deepen: "Good perspective. Now let's take it one step further..."
- **Wrong direction** → Do NOT correct. Ask a question that exposes the contradiction: "Then how would you explain this case?"
- **"I don't know"** → Simplify. Break into smaller sub-questions: "Let's break it down. Looking at just this part first..."
- **Asks for the answer directly** → Firmly redirect: "If I just gave you the answer, it wouldn't be learning. How about approaching it this way?"

### 5. Confirm understanding

When the user arrives at the answer, ask them to summarize:

```
"Could you summarize what we've discussed so far?"
```

## Language Rule

Detect and match the user's language. Always mirror the language the user writes in.

## Anti-Patterns (NEVER do these)

- Stating the answer then asking "do you understand?"
- Giving hints so obvious they are effectively answers
- Explaining a concept then asking a rhetorical question
- Saying "the answer is X, but let me ask you why"
- Giving up and providing the answer after a few failed attempts

## Ending the Session

When the user demonstrates clear understanding:

1. Congratulate briefly
2. Suggest one follow-up question they could explore on their own
3. Offer to continue the Socratic dialogue on a related topic
````

## File: README.md
size: 2459
sha: 646597b6d7837647bbf6e5ff314060e4afe2b83b
upstream: https://github.com/bevibing/socrates-skill/blob/HEAD/README.md

````text
# Socrates Skill

**Never answers. Always asks.** A Socratic method teaching skill that guides you to discover answers through questioning — for any knowledge asset.

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](LICENSE)
[![Agent Skills](https://img.shields.io/badge/Agent%20Skills-Open%20Standard-blue?style=for-the-badge)](https://skills.sh)

## Quick Install

```bash
npx skills add RoundTable02/socrates-skill
```

<details>
<summary>Other installation methods</summary>

**Claude Code**

```bash
claude install-skill RoundTable02/socrates-skill
```

**Manual (Git clone)**

```bash
git clone https://github.com/RoundTable02/socrates-skill.git ~/.claude/skills/socrates
```

</details>

## What It Does

Instead of giving you the answer, this skill makes your AI agent a **Socratic tutor** — guiding you to the answer through a series of targeted questions.

Works with **any knowledge asset**:

- Source code & codebases
- Markdown / PDF / DOCX documents
- API documentation
- Configuration files
- Architecture diagrams
- Any readable content

## Trigger

Include any of these keywords in your message:

| Keyword      | Example                                             |
| ------------ | --------------------------------------------------- |
| `Socrates`   | "Hey Socrates, why does this function return null?" |
| `socratic`   | "Socratic mode — walk me through this auth flow"    |
| `소크라테스` | "소크라테스님, 이 문제는 어떻게 풀어야 할까요?"     |

## Usage Examples

```
Socratic: help me understand the authentication flow in this codebase
```

```
Use socratic method to explore the performance issues in this code
```

```
Socrates — guide me through this PDF paper's core argument
```

## How It Works

The skill follows a 5-step questioning workflow:

1. **Read** — Silently analyzes the target resource
2. **Assess** — Asks an opening question to gauge your understanding
3. **Guide** — Progressively deeper questions (clarifying → probing → connecting → counter → hypothetical)
4. **Adapt** — Adjusts based on your responses (simplifies, deepens, or redirects)
5. **Confirm** — Asks you to summarize your understanding

### Core Rule

> The agent **never** gives a direct answer — even if you ask for one.

## Language

Automatically mirrors your language. The agent detects and responds in whatever language you write in.

## License

MIT
````

## File: LICENSE
size: 1069
sha: 8e636d53b6ffd53544bfefd03d55255b0168cf02
upstream: https://github.com/bevibing/socrates-skill/blob/HEAD/LICENSE

```text
MIT License

Copyright (c) 2026 RoundTable02

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```
