⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

socrates

bevibing@bevibing⭐ 370 stars· last commit 7mo ago· 1 open issues

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.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐⭐⭐ 370 on GitHubGitHub ↗

Popular

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

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 Agent Skills

Quick Install

npx skills add RoundTable02/socrates-skill

Claude Code

claude install-skill RoundTable02/socrates-skill

Manual (Git clone)

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

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:

KeywordExample
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

// HOW IT'S BUILT

// FILES

3 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • SKILL.md3.0 KBe2fe3f698f90upstream ↗
    ---
    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
    
  • README.md2.4 KB646597b6d783upstream ↗
    # 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
    
  • LICENSE1.0 KB8e636d53b6ffupstream ↗
    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.
    

Plain-text copy, no login: /skill-bundles/bevibing-socrates-skill.md

// REPO STATS

370 stars
1 open issues
Last commit: 7mo ago