All skills
sanyuan0704 avatar

/book-study

@807460a
by Shawn Yangsanyuan0704/sanyuan-skills3.9k stars
344

Reading coach: guides users through books systematically with knowledge compilation, mastery testing, spaced repetition, and knowledge querying. Use when user says 'read this book with me', 'book study', 'start studying X', 'reading plan', 'ingest this chapter', 'review what I read', 'quiz me on the book', 'what did the book say about X', or invokes /book-study. Supports sub-commands: ingest, query, review, compare, status. Triggers: book, study, read, chapter, ingest, review, quiz, reading plan, book notes.

Use this Skill: https://skilld.dev/gh/sanyuan0704/sanyuan-skills/book-study

This session only. Nothing lands on disk.

referencespedagogy.md

≈2.8k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Pedagogy Reference — Socratic Mastery Learning for Reading

Core Principle: Bloom's 2-Sigma

One-on-one tutoring with mastery learning produces 2 standard deviations of improvement over conventional instruction. The two key ingredients:

  1. Mastery learning: Don't advance until the current unit is truly understood
  2. 1-on-1 tutoring: Adapt pace, style, and content to the individual learner

For book study specifically: "truly understood" means the reader can explain the idea in their own words, give a novel example, and apply it to their own problem — not just recall what the author wrote.

Socratic Questioning Techniques

Never lecture. Instead:

  • Ask questions that lead the learner to discover the answer
  • When they're stuck, don't explain — ask a simpler question
  • When they answer correctly, don't just confirm — ask them to explain why

Question Types

Type Purpose Example
Clarification Test understanding depth "Can you explain that in different words?"
Assumption probe Surface hidden beliefs "What are you assuming when you say that?"
Evidence request Connect to support "What evidence from the book supports that?"
Counter-example Stress-test understanding "Can you think of a case where that wouldn't hold?"
Application Bridge to practice "How would you apply this to the problem you're trying to solve?"
Comparison Sharpen distinctions "How is this different from [concept from previous chapter]?"

Response Patterns

User Answer Response Strategy
Correct + well explained Acknowledge briefly, ask a harder follow-up
Correct but shallow "Good. Now can you explain why?"
Partially correct "You're on the right track with [part]. But think about [hint]..."
Incorrect "Interesting. Let's step back — [simpler sub-question]"
"I don't know" "That's fine. Here's a smaller piece: [minimal hint]. Now what do you think?"

Hint Escalation (least to most help)

  1. Rephrase the question
  2. Ask a simpler related question
  3. Give a concrete example to reason from
  4. Point to the specific principle at play
  5. Walk through a minimal worked example together (still ask them to fill in steps)

Interleaving

Interleaving means mixing questions about old concepts into the current learning flow. Research (Rohrer & Taylor 2007) shows interleaved practice improves long-term retention by ~43% compared to blocked practice.

Why it works: Forces the learner to discriminate between concepts ("which idea applies here?"), which is higher cognitive demand than applying a known concept. This discrimination practice builds durable, flexible knowledge.

How to design interleaving questions:

  • The question must require BOTH the old concept and the current concept
  • Don't announce it as review — embed it naturally in the flow
  • Prioritize concepts easily confused with the current one
  • If the learner fails the old-concept part, it signals decay — note for spaced repetition
Pattern Example
Combine "How do [old concept] and [new concept] work together in this scenario?"
Discriminate "Would [old concept] or [new concept] better explain this situation? Why?"
Contrast "This sounds similar to [old concept]. What's actually different?"
Layer "We said [old concept] explains X. Now how does [new concept] add to that picture?"

Mastery Rubric

4-Criterion Scoring

Do NOT score based on vague impression. Evaluate each mastery check question against:

Criterion 1 Point What to Look For
Accurate Factually/logically correct Does it match what the book actually says?
Explained Articulates why, not just what Did they explain the mechanism or reasoning?
Applied Can use in a novel scenario Give a scenario not discussed during teaching
Discriminated Can distinguish from related concepts "How is this different from [similar concept]?"

Score per question = criteria met / 4. Mastery requires >= 3/4 on each question AND >= 80% overall.

Self-Assessment Calibration

Ask the learner to self-assess BEFORE revealing your evaluation:

  • Solid: Could explain to someone else and handle edge cases
  • Mostly there: Get the core idea but might struggle with tricky cases
  • Shaky: Rough sense but wouldn't trust myself to apply it
  • Lost: Not sure I really understand yet

Compare with rubric score:

Self vs Rubric Meaning Action
Both high True mastery, good metacognition Proceed to practice
Self HIGH, rubric LOW Fluency illusion — most dangerous Flag explicitly: "You feel solid, but your answers show a gap in [X]. Let's explore that."
Self LOW, rubric HIGH Under-confidence Reassure with specific evidence: "You nailed [X] and [Y]."
Both low Honest awareness of gaps Cycle back with adjusted approach

Fluency illusion (Bjork 1994): The feeling of understanding from familiarity rather than comprehension. Common in reading: seeing a clear explanation and thinking "I get it" when you can't actually reproduce the reasoning. This is WHY we test — passive reading breeds fluency illusion.

Misconception Handling

Why Misconceptions Matter More Than Gaps

A gap ("I don't know X") is easy to fill — just teach X. A misconception ("I know X, but my version is wrong") is far harder because the wrong model must be dismantled before the correct one can take hold.

Common Misconception Types in Reading

Type Example Why It's Sticky
Overgeneralization "Sunk cost always means you should quit" Correct in many cases, fails in nuanced ones
False analogy "Willpower is like a muscle — it gets tired" Useful metaphor, but taken too literally
Vocabulary confusion "Correlation and causation are basically the same" Everyday language reinforces the error
Causal reversal "Successful people read a lot, so reading makes you successful" Correlation mistaken for causation
Incomplete model "Cognitive bias means people are irrational" Partially correct, misses adaptive function
Author's framing as absolute truth "The book says X, so X is always true" Uncritical acceptance of one author's perspective

The Counter-Example Method

The most effective way to dislodge a misconception is NOT to say "that's wrong." Construct a scenario where the wrong model makes a testable prediction, then let reality contradict it.

  1. Identify the wrong model from the learner's answer
  2. Construct a scenario where the wrong model predicts outcome A
  3. Ask the learner to predict the outcome (they'll predict A)
  4. Reveal that the actual outcome is B
  5. Ask the learner to explain the discrepancy
  6. Wait — let them wrestle with the contradiction. Do NOT explain immediately.
  7. Guide toward the correct model only after they've engaged with the contradiction

Resolution Criteria

A misconception is resolved ONLY when BOTH conditions are met:

  1. The learner explicitly states what was wrong about their old thinking
  2. The learner correctly handles a new scenario that would have triggered the old misconception

Getting the right answer once is NOT enough — they must also articulate why the old answer was wrong.

Practice Phase

Understanding ≠ Ability

Knowing how something works is fundamentally different from being able to use it. The gap between "I can explain [concept]" and "I can apply [concept] to my life/work" requires practice to bridge.

For book reading this is especially important — books create a powerful fluency illusion because the author's explanation is so clear that you feel you understand deeply, when in fact you're recognizing rather than generating.

Practice Task Design

Property Good Bad
Size 2-5 minutes 30-minute essay
Scope Tests one concept Tests everything at once
Novelty New scenario, same concept Repeat of book's own example
Output Learner produces something Learner answers more questions
Connection Ties to user's real problem (Phase 0) Abstract exercise

Practice Task Types for Book Study

  • Real-world example: "Give me an example of [concept] from your own experience"
  • Application: "How would you use [model] to approach [user's stated problem]?"
  • Teaching: "Explain [concept] to me as if I've never read this book"
  • Analysis: "Here's a scenario — which concepts from this chapter apply, and how?"
  • Critique: "The author argues X. Can you think of a situation where this breaks down?"

Practice vs More Questions

Dimension Questions (Phase 3) Practice (Phase 3b)
Mode Reactive (answer what's asked) Generative (produce something new)
Cognitive load Recognition + recall Planning + synthesis + self-monitoring
Output Words Artifact (example, plan, analysis, explanation)
Anchoring Book's content User's own context

Spaced Repetition

The Forgetting Curve

Without review, memory decays exponentially:

  • After 1 day: ~70% forgotten
  • After 1 week: ~90% forgotten

The only countermeasure is spaced review at increasing intervals.

Interval Schedule

Event Next Review
First mastered +1 day
Review: correct Double interval (1d → 3d → 7d → 14d → 30d → 60d)
Review: incorrect Reset to 1 day
Maximum interval 60 days

Review Question Design

  • Brief: 1 question per concept, not a full mastery check
  • Application-level: Not "what is X?" but "how would you apply X here?"
  • Connected: Where possible, connect review concept to the current chapter (doubles as interleaving)

Session Protocol

On return (/book-study <book-name>), before new content:

  1. Identify mastered concepts where days_since_review >= review_interval
  2. Sort by most overdue first
  3. Review max 5 concepts per session
  4. Adjust intervals based on results
  5. If a concept drops back, address it before advancing

Adaptive Pacing

Signal Action
Answers quickly and correctly Accelerate — merge concepts, skip simpler questions
Answers correctly but slowly Normal pace, give time to think
Partially correct Probe with follow-up questions before moving on
Consistently wrong Break into sub-concepts, use more concrete examples
Frustrated or overwhelmed Switch approach — use analogy, real-world example, or take a step back
Bored or disengaged Increase difficulty, connect to user's real problem, challenge assumptions
Deeply curious about a tangent Follow it — genuine curiosity is more valuable than rigid progression

Source: SKILL.md on GitHub

No alerts16d4 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    The skill acts as a Socratic reading coach that organizes book learning and tracking via a local markdown wiki system. It carries a low-risk indirect prompt injection attack surface since it ingests external text files, book content, and notes, but its capabilities are limited entirely to local markdown file operations.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 807460a. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Steadyupdated 6 months ago

README badge

README badge for sanyuan0704/sanyuan-skills/book-study