Agent skill

Socratic Tutor

by mingchen666 in mingchen666/Reviva

Guide users through learning by asking questions, giving progressive hints, and helping them reason step by step instead of immediately giving answers.

No licenceAuto-check passedEducation

Install Socratic Tutor

skills CLI
$ npx skills add mingchen666/Reviva --skill socratic-tutor -a claude-code

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

GitHub CLI
$ gh skill install mingchen666/Reviva socratic-tutor --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/mingchen666/Reviva.git skills-src && mkdir -p .claude/skills && cp -r skills-src/electron/builtin-assets/skills/socratic-tutor .claude/skills/socratic-tutor && 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
socratic-tutor
GitHub stars
241
Token cost
~1.8k tokens
SKILL.md length
773 words
Files
2
Skills in repo
54
Repo updated
First seen
Licence
None found

At a glance

Guide users through learning by asking questions, giving progressive hints, and helping them reason step by step instead of immediately giving answers.

  • Works in 7 steps: Read the relevant content before tutoring. → Treat the provided material as the… → Use the terminology, formulas,… → …
  • Problem solving
  • SKILL.md covers Purpose, When to Use, When Not to Use and Inputs, plus 8 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Socratic Tutor is an agent skill from mingchen666/Reviva. Guide users through learning by asking questions, giving progressive hints, and helping them reason step by step instead of immediately giving answers. Use for homework help, problem solving, concept learning, exam preparation, programming practice, and document-based learning.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `config.json`).

It sits in Education, covering Tutoring and explanations. The repository describes itself as: Local-first AI learning workspace — ask, note, review and create around your own materials. Wiki KB, Agents, Skills, creation tools.Private NotebookLM Alternative.AI….

When your agent uses it

  • Problem solving
  • Concept learning
  • Exam preparation
  • Programming practice

Example prompts

  • “/socratic-tutor”

Workflow steps

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

  1. Read the relevant content before tutoring.
  2. Treat the provided material as the primary source.
  3. Use the terminology, formulas, definitions, and constraints from the document.
  4. Do not invent document content.
  5. If the document is unclear or incomplete, say so.
  6. If tutoring is based on a specific exercise or section, stay within that scope.
  7. Quote or refer to the relevant part when useful.

What it can do on your machine

Read from SKILL.md and the folder at commit 24bde40. 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

Socratic Tutor loads about 1.8k tokens when it runs. Until then it costs about 73 tokens; SKILL.md has 773 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~73
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 773 words (~1,826 tokens).

“This skill enables the agent to tutor users through guided questioning and progressive hints.”

— opening of SKILL.md by mingchen666
name
socratic-tutor

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in electron/builtin-assets/skills/socratic-tutor of mingchen666/Reviva.

  • SKILL.md
  • config.json

Open the folder on GitHubat commit 24bde40

Compare with similar skills

Socratic Tutor 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.

Socratic Tutor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Socratic Tutor this skillmingchen666/Reviva241—~1.8kAutomated safety check: PassNone
DeepTutor CLIHKUDS/DeepTutor41k—~2.8kAutomated safety check: PassApache-2.0
AI Engineering Project Tutorrohitg00/ai-engineering-from-scratch66k—~1.6kAutomated safety check: PassMIT
Hung-Yi Lee Teaching Stylevoidful/hung-yi-lee-skill1.3k—~13kAutomated safety check: PassNone
Claude Certification Tutorrohitg00/ai-engineering-from-scratch66k—~3kAutomated safety check: PassMIT
StudyVault Quiz Tutorbevibing/tutor-skills1.3k—~1.4kAutomated safety check: PassMIT

Similar skills

  • 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 yesterday
    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
  • Hung-Yi Lee Teaching Style

    voidful/hung-yi-lee-skill

    Explains machine learning, LLMs, AI agents and speech modeling in a Hung-Yi Lee-inspired teaching style, drawing on a knowledge base built from his lectures and research references.

    1.3k GitHub stars~13k tokensUpdated 1 mo ago
    EducationAuto-check passed
  • Claude Certification Tutor

    rohitg00/ai-engineering-from-scratch

    Guides a learner through one of four independent Claude certification tracks with onboarding, lessons, practice labs, mock exams and remediation.

    66k GitHub stars~3k tokensUpdated today
    EducationAuto-check passed
  • StudyVault Quiz Tutor

    bevibing/tutor-skills

    Quizzes you on the notes in an Obsidian StudyVault, tracks proficiency per concept and drills weak areas in four-question rounds.

    1.3k GitHub stars~1.4k tokensUpdated 7 mo ago
    EducationAuto-check passed
  • Designs a review-and-practice lesson around an independent first attempt, targeted feedback, supported practice, a fresh independent check and a next step.

    40k GitHub stars~1.1k tokensUpdated today
    EducationAuto-check passed

More from mingchen666/Reviva

All 54 skills in this repo
  • Geometry Assistant

    mingchen666/Reviva

    A skill your agent uses when rendering high-school solid-geometry problem data into an interactive 3D standalone HTML artifact with known-condition highlights, step-by-step constructions, faces…

    241 GitHub stars~1.2k tokensUpdated 17 days ago
    Auto-check passed
  • Bili Note

    mingchen666/Reviva

    Turn Bilibili videos that are already registered and parsed in MindSpace, or Bilibili opus/article posts, into evidence-linked Markdown learning notes.

    241 GitHub stars~1.1k tokensUpdated 17 days ago
    Auto-check passed
  • Study Companion En

    mingchen666/Reviva

    General study companion for learning, review, exam prep, exam-point analysis, syllabus/exam-outline interpretation, finals speedrun teaching, concept explanation, problem solving, homework coaching…

    241 GitHub stars~5.7k tokensUpdated 17 days ago
    Auto-check passed
  • Design classroom management and differentiated support plans for real teaching constraints.

    241 GitHub stars~1k tokensUpdated 17 days ago
    Auto-check passed
  • Design and generate concept-first learning artifacts: concept cards, visual explanations, diagrams, interactive HTML demos, Manim/math visualizations, matplotlib scientific plots, misconception…

    241 GitHub stars~2.8k tokensUpdated 17 days ago
    Auto-check passed
  • Cs Course Learning

    mingchen666/Reviva

    A skill your agent uses whenever the user is learning computer science core courses, 408, data structures, computer organization, operating systems, computer networks, algorithms, course finals…

    241 GitHub stars~1.2k tokensUpdated 17 days ago
    Auto-check passed

Categories

Questions about Socratic Tutor

What does Socratic Tutor do?

Guide users through learning by asking questions, giving progressive hints, and helping them reason step by step instead of immediately giving answers. Socratic Tutor is an agent skill from mingchen666/Reviva. Guide users through learning by asking questions, giving progressive hints, and helping them reason step by step instead of immediately giving answers.

When should I use Socratic Tutor?

Socratic Tutor fits situations like: problem solving; concept learning; exam preparation; programming practice.

How do I install Socratic Tutor in Claude Code?

Run `npx skills add mingchen666/Reviva --skill socratic-tutor -a claude-code`. Or copy the skill folder (electron/builtin-assets/skills/socratic-tutor in mingchen666/Reviva) into .claude/skills/socratic-tutor in your project. Claude Code loads it when a task matches its description.

How do I install Socratic Tutor in Codex?

Run `npx skills add mingchen666/Reviva --skill socratic-tutor -a codex`. Or copy the skill folder (electron/builtin-assets/skills/socratic-tutor in mingchen666/Reviva) into .agents/skills/socratic-tutor in your project. Codex loads it when a task matches its description.

Can I use Socratic Tutor 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 mingchen666/Reviva --skill socratic-tutor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/socratic-tutor, .gemini/skills/socratic-tutor, .github/skills/socratic-tutor and .opencode/skills/socratic-tutor in your project.

What does Socratic Tutor need to run?

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

Does Socratic Tutor 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 Socratic Tutor 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 Socratic Tutor use?

No licence was found for Socratic Tutor or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Socratic Tutor use?

About 1.8k tokens (SKILL.md is roughly 7.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Socratic Tutor?

Skills that share tags, products or a category with Socratic Tutor: DeepTutor CLI (HKUDS/DeepTutor, 41k stars), AI Engineering Project Tutor (rohitg00/ai-engineering-from-scratch, 66k stars), Hung-Yi Lee Teaching Style (voidful/hung-yi-lee-skill, 1.3k stars) and Claude Certification Tutor (rohitg00/ai-engineering-from-scratch, 66k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Socratic Tutor?

mingchen666 (a GitHub user) maintains it in mingchen666/Reviva, which has 241 GitHub stars. The repository holds 54 skills in this directory. The repository was last updated on September 21, 2026.

Source: mingchen666/Reviva on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.