Sandbox
Sign in
@bevibing/socrates-skill
Skills#Claude Code#Docs#Research#Coding

Socratic teaching skill for Claude Code

This is a Claude Code skill that turns the agent into a Socratic tutor. It works on code, documents, and other readable content by reading first, then asking a sequence of targeted questions, adapting to your answers, and ending with a summary prompt.

309 stars•13 forks•Updated 5mo ago
Who it's for

Builders who use Claude Code and want their agent to guide understanding through questioning.

What it delivers

You can work through code or documents without getting a direct answer, which helps you build your own understanding.

What it does

Question-only tutoring

The skill follows a rule that the agent never gives a direct answer and instead keeps the conversation in question form.

Five-step questioning flow

It uses Read, Assess, Guide, Adapt, and Confirm to move from initial understanding to a final summary.

Any knowledge asset support

It is meant for source code, docs, config files, diagrams, and other readable content.

Keyword trigger

It activates when you include terms like `Socrates`, `socratic`, or `소크라테스` in your message.

Language mirroring

It responds in the language you write in.

How to get it

  1. 1Run
    npx skills add RoundTable02/socrates-skill
  2. 2Claude Code
    claude install-skill RoundTable02/socrates-skill
  3. 3Manual (Git clone)
    git clone https://github.com/RoundTable02/socrates-skill.git ~/.claude/skills/socrates
  4. 4Run
    Socratic: help me understand the authentication flow in this codebase
  5. 5Run
    Use socratic method to explore the performance issues in this code
  6. 6Run
    Socrates — guide me through this PDF paper's core argument

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
Other installation methods

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

Files in the repo

Repository payload•3 top-level entries
  • LICENSE
  • README.md
  • SKILL.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More skills

obra/
superpowers
obra/superpowersSkills

An agentic skills framework & software development methodology that works.

285k
1 add
Graphify-Labs/graphifySkills

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

117k
1 add
Vincentwei1021/
anything2explainer
Vincentwei1021/anything2explainerSkills

Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.

666
career-ops-hq/career-opsSkills

Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)

71k