Repolode
Submit
joeseesun

joeseesun/qiaomu-learning

An Agent Skill that turns a topic, text, web page, screenshot or PDF into a one-question-at-a-time Socratic tutoring session.

View on GitHub
Stars
70
Forks
7
Open issues
0
Last commit
25 days ago

What is it?

qiaomu-learning is an Agent Skill for guided, question-led learning. Given a topic or material, the agent asks exactly one concise question per turn, adjusts difficulty based on the learner's previous answer, and corrects misunderstandings in a teacher-like way instead of delivering the full answer up front. It works from text, web pages, screenshots and PDFs, anchoring questions to the source and separating what the material states from inference or background knowledge.

For broad topics it first builds a 12-keyword map with plain-language explanations and suggested experts and books, then waits for the learner to choose a starting point. For abstract or spatial material it can build visual anchors, including Codex-generated images with text alternatives, and it exits immediately when the learner asks for a direct explanation, summary, pause or stop. On request it can package a lesson as a self-contained offline HTML page with inline CSS and JavaScript.

The project is aimed at learners who want active recall and guided reasoning rather than passive reading. It ships with a validation script and a webpage audit script for checking package structure and HTML self-containment.

Key features

  • 01Asks one learner-facing question per active turn and adapts to each answer.
  • 02Starts broad topics with a 12-keyword map plus expert and book pointers.
  • 03Anchors questions to page numbers, sections or visible screenshot regions in source material.
  • 04Builds cumulative visual blackboards for spatial, process and geometry concepts.
  • 05Exports a self-contained offline HTML study page on request.

Use cases

  • Studying a textbook chapter or PDF by answering guided questions instead of re-reading.
  • Learning an unfamiliar technical concept by working through it step by step.
  • Preparing for an exam with active recall rather than summaries.
  • Turning a set of course notes into a single-file review page.

Quick start

  1. 1

    Install the skill with npx

    npx skills add joeseesun/qiaomu-learning
  2. 2

    Ask your agent to tutor you one question at a time on a topic

Things to know

  • Image generation depends on the host's built-in Codex capability and may add latency or cost.
  • Provider-wide compatibility and measured learning outcomes are not yet backed by evidence.

In collections

Open-source AI agent frameworks & appsAI agent skill librariesLearning & education tools

Topics

#ai-agent#agent-skill#education#socratic-learning#active-recall#tutoring#llm#interactive-learning

FAQ

What is qiaomu-learning?
An Agent Skill that turns a topic, text, web page, screenshot or PDF into a one-question-at-a-time Socratic tutoring session. qiaomu-learning is an Agent Skill for guided, question-led learning. Given a topic or material, the agent asks exactly one concise question per turn, adjusts difficulty based on the learner's previous answer, and corrects misunderstandings in a teacher-like way instead of delivering the full answer up front. It works from text, web pages, screenshots and PDFs, anchoring questions to the source and separating what the material states from inference or background knowledge.
Is qiaomu-learning free to use? What license does it have?
qiaomu-learning is open source under the MIT license. Check the license terms before using it in commercial products.
Is qiaomu-learning still maintained?
Actively maintained. The last commit to qiaomu-learning was on Oct 13, 2026.
What can I use qiaomu-learning for?
Studying a textbook chapter or PDF by answering guided questions instead of re-reading. Learning an unfamiliar technical concept by working through it step by step. Preparing for an exam with active recall rather than summaries. Turning a set of course notes into a single-file review page.
How do I install qiaomu-learning?
Install the skill with npx: npx skills add joeseesun/qiaomu-learning Ask your agent to tutor you one question at a time on a topic
Where can I get qiaomu-learning?
The source code and installation instructions are on GitHub: https://github.com/joeseesun/qiaomu-learning

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects