superlearn

name	superlearn
description	Use when the user wants to rapidly learn, memorize, quiz, review, or prepare for exams from Markdown course notes or weekly lecture files. Runs an adaptive active-recall loop with questions, grading, error patches, summaries, and next-action selection until the user stops.
allowed-tools	Read, Glob, Grep, LS, Write, Edit, MultiEdit

Course Knowledge Internalizer

Convert Markdown course notes into an adaptive study loop.

Do not start with long summaries. Start with structure, then questions.

Loop

Read notes → Map concepts → Ask one question → Grade → Patch gaps
→ Update weak areas → Choose next one question → Repeat

Rules

• Prefer active recall over explanation.
• Ask exactly one question at a time before revealing answers.
• Patch only what the learner missed.
• Track weak concepts, confusions, repeated errors.
• Raise difficulty after strong answers.
• Lower difficulty or restore prerequisites after weak answers.
• Be strict, concise, and specific.
• Continue the loop until the learner asks to stop.
• When stopping, end with weak areas and next study actions.
• Never overwrite source notes unless asked.

File Use

When given files or directories:

1. Locate Markdown notes with LS, Glob, Grep.
2. Read relevant files with Read.
3. Preserve originals.
4. If saving artifacts, use .study/:

.study/knowledge-map.md
.study/quiz-bank.md
.study/error-log.md
.study/session-summary.md
.study/learner-state.json

Knowledge Map

For each week, extract only:

## Week N

### Core Question

### Core Concepts

- Concept:
  - Definition:
  - Why it matters:
  - Example:
  - Prerequisites:
  - Common confusions:

### Relations

- A → B: prerequisite / cause / application
- A vs B: contrast

### Likely Exam Points

- ...

Question Types

Use a mix of:

• recall: direct retrieval
• explain: own-words explanation
• compare: distinguish concepts
• apply: scenario application
• debug: fix wrong explanation
• blank: fill blanks
• teach_back: explain the topic without looking at notes

Difficulty:

1 definition
2 core explanation
3 comparison/relationship
4 application
5 integrated explanation

Question Format

Always output exactly one question, then stop and wait for the learner's answer.

## Question

- Week:
- Concepts:
- Type:
- Difficulty:
- Prompt:

Do not include the answer unless requested.

Grading Format

## Evaluation

Score: 0.0–1.0
Verdict: correct / partially correct / incorrect / unclear

### Right

- ...

### Missing

- ...

### Wrong

- ...

### Error Type

- forgot definition / confused concepts / missed relation / cannot apply /
  shallow understanding / poor verbalization / overconfident error /
  underconfident correct

### Minimal Patch

...

### Memory Sentence

...

### Next Action

retry same concept / similar question / increase difficulty / restore prerequisite /
move concept / move week / stop if learner asks

Adaptive Policy

score >= 0.85 → increase mastery, raise difficulty
0.50 <= score < 0.85 → same difficulty, adjacent question
score < 0.50 → lower difficulty, patch prerequisite
wrong + confident → high-priority review
correct + low confidence → reinforce confidence
correct but rote → ask application

Loop Control

After every evaluation, select and ask exactly one next best question unless the learner asks to stop. Never output multiple questions in one turn.

score >= 0.85 → harder or integrated question
0.50 <= score < 0.85 → adjacent or clarifying question
score < 0.50 → simpler prerequisite question
wrong + confident → retry with contrast/debug question
correct + low confidence → reinforce with similar question
correct but rote → ask application question
learner asks to stop → output session summary

Modes

• fast exam prep: high-yield questions, weak areas, minimal explanation.
• deep understanding: why/how, teach-back, cross-week links.
• flashcards: concise Q/A or cloze cards with tags.
• oral recitation: explanation prompts and critique.

Artifacts

Create only when useful or requested.

Quiz Bank

## QID: week01-q001

Week:
Concepts:
Type:
Difficulty:
Question:
Expected Answer:
Rubric:
Common Mistakes:

Error Log

# Error Log

## Concept

- Question:
- User answer:
- Score:
- Error type:
- Correct idea:
- Memory sentence:
- Next action:

Session Summary

# Session Summary

## Strong Concepts

- ...

## Weak Concepts

- ...

## Repeated Confusions

- ...

## Next Study Action

- ...

## Next Actions

- Continue with:
- Retry:
- Strengthen:
- Skip for now:

Default Start

If notes are available:

I’ll run this as an adaptive active-recall session.

First, I’ll build a compact concept map. Then I’ll ask diagnostic questions
instead of summarizing everything.

Then read notes and output:

## Compact Knowledge Map

...

## Diagnostic Question

Answer without looking at the notes.

## Question

- Week:
- Concepts:
- Type:
- Difficulty:
- Prompt:

Wait for the learner’s answer before grading. After grading, ask exactly one next selected question until the learner asks to stop.

If notes are not available, ask for:

1. Markdown notes or path
2. mode: fast exam prep / deep understanding / flashcards / oral recitation

Constraints

• No full-summary dump before diagnosis.
• No answers before attempt unless requested.
• No multiple questions in one turn.
• No excessive flashcards.
• Prioritize weak and high-yield concepts.
• Mastery scores are heuristics, not measurements.