Agent skill

Hum Socratic

by asgard-ai-platform in asgard-ai-platform/skills

Apply Socratic questioning — systematic inquiry via clarification, assumption-probing, evidence-testing, perspective-shifting, implication-tracing, and meta-questions — to coach learning or surface…

MITAuto-check passedEducation

Install Hum Socratic

skills CLI
$ npx skills add asgard-ai-platform/skills --skill hum-socratic -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install asgard-ai-platform/skills hum-socratic --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/asgard-ai-platform/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/hum-socratic .claude/skills/hum-socratic && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
hum-socratic
GitHub stars
242
Token cost
~1.3k tokens
SKILL.md length
377 words
Files
3 (incl. references)
Skills in repo
207
Repo updated
First seen
Licence
MIT

At a glance

Apply Socratic questioning — systematic inquiry via clarification, assumption-probing, evidence-testing, perspective-shifting, implication-tracing, and meta-questions — to coach learning or surface…

  • Works in 6 steps: Clarify the thinker's claim precisely → Probe assumptions — what must be true… → Request evidence — what supports the… → …
  • The user is explicitly facilitating learning
  • SKILL.md covers Overview, Framework, Output Format and Examples, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Hum Socratic is an agent skill from asgard-ai-platform/skills. Apply Socratic questioning — systematic inquiry via clarification, assumption-probing, evidence-testing, perspective-shifting, implication-tracing, and meta-questions — to coach learning or surface hidden assumptions in a person's reasoning. Use this skill when the user is explicitly facilitating learning, coaching a person through their own thinking, or needs a structured questioning sequence to probe a held belief, even if they say 'play devil's advocate on this claim' or 'how should I coach my team through…

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `examples/sample_scenario.md` and `references/facilitation-guide.md`).

It sits in Education, covering Tutoring and explanations. The repository describes itself as: 301 open-source coding agent skills across 22 domains — methodology, judgment & gotchas packaged as Claude Agent Skills for the Asgard AI Platform. The licence is MIT.

When your agent uses it

  • The user is explicitly facilitating learning
  • Coaching a person through their own thinking
  • Needs a structured questioning sequence to probe a held belief
  • Even if they say play devils advocate on this claim

Example prompts

  • “play devil”
  • “how should I coach my team through this problem via questions”
  • “/hum-socratic”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Clarify the thinker's claim precisely
  2. Probe assumptions — what must be true for the claim to hold?
  3. Request evidence — what supports the belief? Is it sufficient?
  4. Introduce counter-perspectives — what would a critic say?
  5. Explore implications — if right, what follows? If wrong, what changes?
  6. Synthesize (the IRON LAW checkpoint) — summarize, confirm understanding, then continue

What it can do on your machine

Read from SKILL.md and the folder at commit 4e7f4f8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Hum Socratic loads about 1.3k tokens when it runs, and up to ~4.6k if it reads all its reference files. Until then it costs about 174 tokens; SKILL.md has 377 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~174
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from asgard-ai-platform/skills at commit 4e7f4f8, republished under its MIT licence (© asgard-ai-platform). 377 words, ~1,259 tokens.

Download SKILL.mdSave it as .claude/skills/hum-socratic/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
hum-socratic
description
Apply Socratic questioning — systematic inquiry via clarification, assumption-probing, evidence-testing, perspective-shifting, implication-tracing, and meta-questions — to coach learning or surface hidden assumptions in a person's reasoning. Use this skill when the user is explicitly facilitating learning, coaching a person through their own thinking, or needs a structured questioning sequence to probe a held belief, even if they say 'play devil's advocate on this claim' or 'how should I coach my team through this problem via questions'. Do NOT use for open-ended brainstorming, information gathering, or requirements-discovery question lists where no belief is being probed.
metadata.category
WP-19 文學院/人文
metadata.tags
humanities, socratic-method, questioning, pedagogy

Socratic Questioning

Overview

The Socratic method uses disciplined questioning to examine ideas, uncover assumptions, and develop deeper understanding. Instead of providing answers, it guides the thinker to discover insights through their own reasoning — making conclusions more durable and personally meaningful.

Framework

IRON LAW: More Than 3 Consecutive Questions Without Summary Produces
Confusion, Not Insight

Agents applying Socratic questioning default to an unbounded chain of
questions. After ~3 questions, the thinker loses the thread — they can't
hold the question hierarchy in working memory. Pause every 2-3 questions
to SUMMARIZE what the thinker has revealed so far ("So your position is X
because Y, but you're unsure about Z — is that right?"). Then resume.
Without this checkpoint, the session feels like an interrogation, not a
guided inquiry.

Also: never ask a question whose answer you already embedded in the
phrasing. "Don't you think X is problematic?" is a leading assertion
disguised as a question. Rephrase as "What are the consequences of X?"
Facilitation Flow
  1. Clarify the thinker's claim precisely
  2. Probe assumptions — what must be true for the claim to hold?
  3. Request evidence — what supports the belief? Is it sufficient?
  4. Introduce counter-perspectives — what would a critic say?
  5. Explore implications — if right, what follows? If wrong, what changes?
  6. Synthesize (the IRON LAW checkpoint) — summarize, confirm understanding, then continue

For the six question types (clarification, assumptions, evidence, perspectives, implications, meta-questions) and scaffolding techniques (maieutics), see references/facilitation-guide.md.

Output Format

When applying Socratic questioning, output a structured question sequence:

markdown
# Socratic Inquiry: {Topic}

## Starting Position
{The thinker's current belief or question}

## Question Sequence
1. [Clarification] {question}
   → Expected insight: {what this reveals}
2. [Assumption] {question}
   → Expected insight: {what this surfaces}
3. [Evidence] {question}
   → Expected insight: ...
4. [Perspective] {question}
   → Expected insight: ...
5. [Implication] {question}
   → Expected insight: ...

## Target Insight
{What the thinker should arrive at through this sequence}

Examples

Correct Application

Scenario: Student says "AI will replace all jobs"

Socratic sequence:

  1. [Clarification] "When you say 'all jobs', do you mean literally every job, or most jobs?"
  2. [Evidence] "What evidence have you seen that suggests this?"
  3. [Assumption] "What are you assuming about AI's capabilities? Are there tasks that require something AI can't do?"
  4. [Perspective] "Historically, what happened to employment after previous technological revolutions like the Industrial Revolution?"
  5. [Implication] "If AI replaced all jobs, how would people earn money to buy the things AI produces?"

→ The student arrives at a more nuanced view: AI will transform jobs, not eliminate all of them ✓

Show full SKILL.md (141 more words)Show less
Incorrect Application
  • Student: "AI will replace all jobs" → Teacher: "No it won't. Here's why..." → Provided the answer directly. Not Socratic. Violates Iron Law.

Gotchas

  • Socratic method can feel adversarial: Frame questions with genuine curiosity, not as cross-examination. "I'm curious about..." softens the tone.
  • Know when to stop: If the thinker is frustrated or going in circles, provide a hint or redirect. The method serves learning, not ego.
  • Not all contexts suit Socratic questioning: Emergency decisions, time-sensitive situations, and purely factual questions ("what's the capital of France?") don't benefit from Socratic inquiry.
  • The facilitator must actually listen: The next question should respond to what the thinker said, not follow a predetermined script. Flexibility is essential.
  • Cultural sensitivity: In some cultures, questioning authority or being questioned publicly is uncomfortable. Adapt the setting (one-on-one, written) and framing.

References

  • For classroom facilitation techniques, see references/facilitation-guide.md

© asgard-ai-platform, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in hum-socratic of asgard-ai-platform/skills.

  • SKILL.md
  • examples/sample_scenario.md
  • references/facilitation-guide.md

Open the folder on GitHubat commit 4e7f4f8

Compare with similar skills

Hum Socratic next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Hum Socratic compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hum Socratic this skillasgard-ai-platform/skills242—~1.3kAutomated safety check: PassMIT
MCPA Certification Tutorrohitg00/ai-engineering-from-scratch66k—~3.5kAutomated safety check: PassMIT
Learn MCP Tutorrohitg00/ai-engineering-from-scratch66k—~2.4kAutomated safety check: PassMIT
Yao Bayesian Skillyaojingang/yao-open-skills1.3k—~956Automated safety check: PassMIT
Drill Medavepoon/buildwithclaude3.6k—~697Automated safety check: NotesMIT
DeepTutor CLIHKUDS/DeepTutor41k—~2.8kAutomated safety check: PassApache-2.0

Similar skills

  • MCPA Certification Tutor

    rohitg00/ai-engineering-from-scratch

    Turns a GitHub course repository into an interactive tutor for the MCP Associate certification, making the learner explain and defend each step.

    66k GitHub stars~3.5k tokensUpdated today
    EducationAuto-check passed
  • Learn MCP Tutor

    rohitg00/ai-engineering-from-scratch

    An interactive tutor for the Model Context Protocol path in AI Engineering from Scratch, teaching one lesson per invocation and recording wire evidence in MCP-LEARNING.md.

    66k GitHub stars~2.4k tokensUpdated today
    EducationAuto-check passed
  • Yao Bayesian Skill

    yaojingang/yao-open-skills

    Convert uncertain real-world choices into an auditable Bayesian evidence-to-action report with priors, evidence grading, posterior update, action thresholds, sensitivity checks, multi-turn decision…

    1.3k GitHub stars~956 tokensUpdated 1 mo ago
    EducationAuto-check passed
  • Drill Me

    davepoon/buildwithclaude

    Teach the user a topic as an adaptive tutor — retrieval practice, spaced repetition with decay, and persistent memory in ~/.drill-me/.

    3.6k GitHub stars~697 tokensUpdated yesterday
    EducationAuto-check: notes
  • DeepTutor CLI

    HKUDS/DeepTutor

    Teaches the agent to set up and run DeepTutor from the command line: chat and capabilities, knowledge bases, partners, memory, sessions, notebooks and the server or Web app.

    41k GitHub stars~2.8k tokensUpdated 2 days ago
    EducationAuto-check passed
  • AI Engineering Project Tutor

    rohitg00/ai-engineering-from-scratch

    Tutors a learner through one stage of a hands-on AI engineering project per session: lesson, prediction, code, grader run and reflection, with hints but never full solutions.

    66k GitHub stars~1.6k tokensUpdated today
    EducationAuto-check passed

More from asgard-ai-platform/skills

All 207 skills in this repo
  • Algo Ecom Bm25

    asgard-ai-platform/skills

    Implement BM25 ranking function for e-commerce product search relevance scoring.

    242 GitHub stars~1.4k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Mfg Cpk

    asgard-ai-platform/skills

    Calculate Cpk process capability index to assess whether a process meets specification requirements.

    242 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Price Elasticity

    asgard-ai-platform/skills

    Calculate price elasticity of demand to quantify how price changes affect sales volume.

    242 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Rank Bayesian

    asgard-ai-platform/skills

    Apply Bayesian averaging to rank items by combining observed ratings with prior expectations.

    242 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Rank Elo

    asgard-ai-platform/skills

    Implement Elo rating system to rank items or players from pairwise comparison outcomes.

    242 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Rank Wilson

    asgard-ai-platform/skills

    Calculate Wilson Score confidence intervals for ranking items by positive proportion with sample size correction.

    242 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed

Questions about Hum Socratic

What does Hum Socratic do?

Apply Socratic questioning — systematic inquiry via clarification, assumption-probing, evidence-testing, perspective-shifting, implication-tracing, and meta-questions — to coach learning or surface…. Hum Socratic is an agent skill from asgard-ai-platform/skills. Apply Socratic questioning — systematic inquiry via clarification, assumption-probing, evidence-testing, perspective-shifting, implication-tracing, and meta-questions — to coach learning or surface hidden assumptions in a person's reasoning.

When should I use Hum Socratic?

Hum Socratic fits situations like: the user is explicitly facilitating learning; coaching a person through their own thinking; needs a structured questioning sequence to probe a held belief; even if they say play devils advocate on this claim.

How do I install Hum Socratic in Claude Code?

Run `npx skills add asgard-ai-platform/skills --skill hum-socratic -a claude-code`. Or copy the skill folder (hum-socratic in asgard-ai-platform/skills) into .claude/skills/hum-socratic in your project. Claude Code loads it when a task matches its description.

How do I install Hum Socratic in Codex?

Run `npx skills add asgard-ai-platform/skills --skill hum-socratic -a codex`. Or copy the skill folder (hum-socratic in asgard-ai-platform/skills) into .agents/skills/hum-socratic in your project. Codex loads it when a task matches its description.

Can I use Hum Socratic in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add asgard-ai-platform/skills --skill hum-socratic -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hum-socratic, .gemini/skills/hum-socratic, .github/skills/hum-socratic and .opencode/skills/hum-socratic in your project.

What does Hum Socratic need to run?

SKILL.md names no scripts, command-line tools or credentials: Hum Socratic is instructions for the agent only.

Does Hum Socratic access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Hum Socratic safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Hum Socratic use?

Hum Socratic is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Hum Socratic use?

About 1.3k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.3k tokens, read only when the agent opens those files.

What are the alternatives to Hum Socratic?

Skills that share tags, products or a category with Hum Socratic: MCPA Certification Tutor (rohitg00/ai-engineering-from-scratch, 66k stars), Learn MCP Tutor (rohitg00/ai-engineering-from-scratch, 66k stars), Yao Bayesian Skill (yaojingang/yao-open-skills, 1.3k stars) and Drill Me (davepoon/buildwithclaude, 3.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hum Socratic?

asgard-ai-platform (a GitHub organization) maintains it in asgard-ai-platform/skills, which has 242 GitHub stars. The repository holds 207 skills in this directory. The repository was last updated on June 6, 2026.

Source: asgard-ai-platform/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.