socratic-quiz

socratic-quiz is a skill for Claude Code from pchalasani/claude-code-tools. It costs 72 tokens per session (759 once invoked), scanned A, original, MIT.

A guided learning method that teaches through one question at a time, adjusting the difficulty to your answers.

In plain words
What is it for?
Use it to learn a topic, test your understanding, or work through code and system behavior with guided questions.
Why use it?
It helps you build understanding by reasoning things out instead of only reading an explanation.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the workflow plugin — 4 skills, 1 agent shipped together

Good fit Use it to learn a topic, test your understanding, or work through code and system behavior with guided questions.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/pchalasani/claude-code-tools/socratic-quiz
About the project

pchalasani/claude-code-tools is a collection of command-line tools, skills, agents, hooks, plugins, and commands for improving work with Claude Code, Codex-CLI, and similar coding agents. It is used by developers who want reusable productivity features and workflows for terminal-based AI coding assistants. The catalogue entries are components of, or extensions for, these coding-agent workflows.

pchalasani/claude-code-tools · 1,994 stars · on GitHub

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add pchalasani/claude-code-tools --skill socratic-quiz
Clone the repo
git clone --depth 1 https://github.com/pchalasani/claude-code-tools

Made for: Claude Code.

Or install workflow, the plugin that ships this one along with the rest of its 4 skills, 1 agent.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for socratic-quiz

README.md
[![agentmods](https://agentmods.dev/badge/skills/pchalasani/claude-code-tools/socratic-quiz.svg)](https://agentmods.dev/skills/pchalasani/claude-code-tools/socratic-quiz)
Your own site
<a href="https://agentmods.dev/skills/pchalasani/claude-code-tools/socratic-quiz"><img src="https://agentmods.dev/badge/skills/pchalasani/claude-code-tools/socratic-quiz.svg" alt="Measured on agentmods" height="20"></a>
Per session 72 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 759 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00072 $0.00759
Opus 5 $0.00036 $0.00380
Sonnet 5 $0.00014 $0.00152
Haiku 4.5 $0.00007 $0.00076

Measured 8d ago against content hash 92470e4bd873, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

socratic-quiz scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/workflow/skills/socratic-quiz/SKILL.md · 106 lines

How it starts

The opening of the file, as written. The whole thing — 106 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Socratic Quiz

Purpose

Guide the user to deep understanding through graduated, adaptive questioning rather than direct explanation. The user learns by thinking through the answers themselves.

Instructions

Starting the quiz

  1. Ask the user what topic or concept they want to understand better (if not already stated).
  2. Gauge their current level by starting with a foundational question — not too easy, not too hard.
  3. Based on their answer, adapt up or down.

Asking questions

  • Ask ONE question at a time. Wait for the user's response before continuing.
  • Start with concrete, grounded questions before moving to abstract or nuanced ones.
  • Frame questions around what the user can observe, reason about, or connect to things they already know.
  • If the topic involves code or a system, reference specific behavior, output, or structure they would encounter — but do NOT show them the answer directly.
  • Use "what do you think would happen if..." and "why do you think..." style questions.

When the user answers correctly

  • Briefly confirm (one sentence max) and immediately move to the next, harder question.
  • Build on their correct answer — use it as a stepping stone to the next concept.

When the user answers incorrectly

  • Do NOT reveal the correct answer.
  • Do NOT say "that's wrong" bluntly. Instead:
    • Acknowledge what's reasonable about their thinking.
    • Ask a narrower or reframed question that exposes the gap in their reasoning.
    • Offer a concrete scenario or counterexample that challenges their answer, and ask them to reconsider.
    • If they're stuck after 2-3 attempts on the same concept, give a small hint (not the answer) and ask again.

When the user is partially correct

  • Acknowledge the correct part explicitly.
  • Ask a follow-up that targets the missing or incorrect part.

Progression

  • Graduate from foundational → intermediate → nuanced.
  • Connect concepts: once the user understands A and B separately, ask a question that requires combining them.
  • Periodically ask "synthesis" questions that tie multiple concepts together.

Read the full file on GitHub · 106 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 106 lines · 72 tokens per session scan A 92470e4bd873

Subscribe to this mod's changes

socratic-quiz is a skill published in the GitHub repository pchalasani/claude-code-tools (1,994 stars, last pushed yesterday), licensed MIT. It adds 72 tokens to every session and 759 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

take-notes

Turn a YouTube video, a web article, or several sources at once into one set of didactic study notes, written as a self-contained HTML page under /take-notes/htmlreports and opened in the browser.

davertor/take-notes · 48 tokens

skill-powerups

Interactive tutorial-style lessons for custom skills. Invoke /powerup for a guided walkthrough with examples, exercises, and knowledge checks. Trigger: When user says "powerup", "tutorial", "teach me", or wants to learn a skill interactively.

JNZader/repoforge · 57 tokens

learning-mode

Turn a regular Claude Code session into a learn-by-doing coding tutorial. The user keeps shipping real work, but at deliberate moments Claude hands off a focused chunk for the user to write by hand, then reviews it. Maintains a per-repo learning plan and a spaced-repetition log under .claude/learning/ so topics…

Osipchuk/agent-skills · 235 tokens

simplicio-learn

Persist what a run taught you so the next run is cheaper and more correct — mine high-signal lessons from the trajectory, dedup them, and write them back to AGENTS.md / memory so they're applied not re-derived. Use after a run or at session end, when the user says "remember this", "do a retrospective", "learn from…

wesleysimplicio/simplicio · 109 tokens

explainer-site

Create "How X Works" deep-dive explainer websites with the curious, technical-but-accessible style of howkeyboardswork.com. Use when asked to explain how something works, create an educational single-page guide, or build an interactive explainer site on any topic.

sciclaw/sciclaw · 59 tokens

onboard-our-stack

Onboard a newcomer to THIS codebase, or answer a targeted "how does our X work" question, by walking curated reading lists and synthesizing the mental model — never by guessing. Works out of the box: with a committed .claude/onboard/topics.yaml it walks that curated path; without one it cold-starts from the repo's own…

Osipchuk/agent-skills · 231 tokens