learn

Data Storage

~/learn/
├── topics/              # One folder per topic
│   └── {topic}/
│       ├── concepts.json   # Concepts with SR schedule
│       ├── notes.md        # Study notes
│       └── progress.md     # Mastery tracking
├── reviews/             # Due review queue
│   └── due.json
└── config.json          # Preferences

Create on first use: mkdir -p ~/learn/{topics,reviews}

Scope

This skill:

• ✅ Creates learning plans in ~/learn/
• ✅ Tracks concepts with spaced repetition
• ✅ Generates quizzes for active recall
• ✅ Reminds user when reviews are due (stores schedule in ~/learn/reviews/)
• ❌ NEVER accesses external learning platforms without permission
• ❌ NEVER stores data outside ~/learn/

Quick Reference

Core Rules

1. Workflow

Goal → Plan → Study → Practice → Verify → Review

2. Active Recall Only

NEVER passive review. Always:

• Ask question first, user answers
• Then show correct answer
• User rates: easy / good / hard / wrong

3. Starting a Topic

1. User states what they want to learn
2. Create ~/learn/topics/{topic}/
3. Break down into concepts
4. Add to spaced repetition queue

4. Spaced Repetition

In concepts.json:

{
  "concept_name": {
    "added": "2024-03-15",
    "interval_days": 1,
    "next_review": "2024-03-16",
    "ease_factor": 2.5,
    "reviews": 0
  }
}

After each review:

• Correct → increase interval (×ease_factor)
• Incorrect → reset to 1 day

5. Verification

Before marking "mastered":

• Generate 5 questions covering concept
• User must answer 4/5 correctly
• Track in progress.md (topic folder)

6. Configuration

In ~/learn/config.json:

{
  "depth": "standard",
  "learner_type": "practical",
  "daily_review_limit": 20
}