qiaomu-learning

Conducts adaptive Socratic tutoring dialogues with one question per turn from topics, text, screenshots, or PDFs.

56|3|Updated Aug 10, 2026
One-click install
npx skills add https://github.com/joeseesun/qiaomu-learning --skill qiaomu-learning-joeseesun
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: qiaomu-learning
Source: https://github.com/joeseesun/qiaomu-learning
Command: npx skills add https://github.com/joeseesun/qiaomu-learning --skill qiaomu-learning-joeseesun

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Passive reading and direct answers rarely build durable understanding. This Skill turns a topic, text passage, webpage, screenshot, or PDF into an interactive Socratic learning dialogue where the learner reasons through exactly one question per turn, with adaptive follow-ups, gentle misconception repair, and a cumulative blackboard that builds from concrete examples to formal symbols. ## Core Features & Use Cases - One-question-per-turn tutoring: Each active turn asks a single concise learner-facing question, adapts to correct, partial, mistaken, or stalled answers, and exits immediately when the learner asks to stop or wants a direct explanation. - 12-keyword orientation map: For broad topics, it first builds a map of exactly 12 plain-language keywords plus 3-5 expert and book entrances, then lets the learner pick a starting point; expansion happens only on explicit request. - Progressive blackboard and visual scaffolding: Abstract, spatial, geometric, and calculus topics advance through cumulative visual frames with text alternatives, using authorized built-in image generation only when it adds real structure. - Self-contained learning webpages: On explicit request, it packages a lesson into a single offline HTML file with inline CSS/JS, no CDN, no telemetry, and no default deployment. - Use Case: A learner pastes a PDF chapter on opportunity cost and asks to be taught one question at a time; the Skill anchors questions to page numbers, distinguishes source statements from inference, and tracks mastery only after the learner explains concepts in their own words and transfers them to new contexts. ## Quick Start Ask your agent to teach you a topic or document Socratically, one question at a time, for example: use qiaomu-learning to teach me opportunity cost from this PDF, asking only one question per turn.

Frequently Asked Questions about qiaomu-learning

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start Socratic one-question-at-a-time tutoring with an AI agent?▼

Install the skill with npx skills add joeseesun/qiaomu-learning, then explicitly ask for interactive learning, such as requesting Socratic tutoring on a topic or document one question at a time. The skill activates only on explicit opt-in and asks exactly one learner-facing question per turn.

What inputs can this tutoring skill teach from?▼

It accepts a broad topic, user-provided text, an authorized accessible webpage, a screenshot, or a PDF. For broad topics it first builds a 12-keyword orientation map with expert and book entrances before formal questioning begins.

Does it work without image generation or network access?▼

Yes. Network, file writes, and image generation are all optional; the default flow is text-only dialogue. When image generation is unavailable, declined, or fails, it falls back to text, ASCII, or deterministic sketches and continues with one stepped-down question.

Can it generate an interactive learning webpage?▼

Only on explicit request. It produces a single self-contained HTML file with inline CSS and JavaScript, no CDN, telemetry, or default deployment, and the page keeps one current cognitive step while open-ended answers return to the dialogue.

When should I not use this skill?▼

Do not use it for direct explanations, summaries, translations, problem solving, grading, batch quiz generation, or standalone image requests; those are handled as ordinary direct answers. It also will not complete proctored exams or assignments that prohibit outside help.