spaced-repetition

Schedules review items and tracks recall scores using the SM-2 spaced repetition algorithm.

Updated Jun 15, 2026
One-click install
npx skills add https://github.com/kmjy98-sketch/khulaw --skill spaced-repetition-kmjy98-sketch
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spaced-repetition
Source: https://github.com/kmjy98-sketch/khulaw/tree/main/.agent/skills/spaced-repetition
Command: npx skills add https://github.com/kmjy98-sketch/khulaw --skill spaced-repetition-kmjy98-sketch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Forgetting learned material is inevitable without structured review. This Skill manages a persistent review schedule so you always know which law study items are due today, and it adjusts intervals automatically based on how well you recall each item. ## Core Features & Use Cases - SM-2 Scheduling: Computes next review dates from a 0-5 recall score, adjusting easiness factor and interval per the classic SM-2 algorithm. - Daily Review Queue: Lists all items due today, sorted by priority derived from past scores. - Weak-Point Sync: Imports weak points from learning.json into the review queue with high priority, avoiding duplicate entries. - Use Case: After a graded case-answer review, register missed issues as review items with an initial due date (D+1 to D+7 by error type), then let SM-2 manage subsequent intervals. ## Quick Start Ask the assistant to show today's review items by running the spaced-repetition scheduler with the --today flag.

Frequently Asked Questions about spaced-repetition

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

FAQPage Schema
How do I check which review items are due today?▼

Run the scheduler script with the --today flag: python scripts/srs_scheduler.py --today. It prints all items whose next_review date is today or earlier, sorted by priority, due date, and repetition count.

How does the SM-2 algorithm calculate the next review date?▼

Scores of 3 or higher increase the interval (1 day, then 6 days, then interval times the easiness factor). Scores below 3 reset repetitions to zero and the interval to 1 day. The easiness factor adjusts between roughly 1.3 and 2.5 based on score.

What do the 0-5 review scores mean in SM-2?▼

0 means complete forgetting, 1-2 means wrong answer requiring relearning, 3 means correct but difficult, 4 means correct, and 5 means very easy. Lower scores also raise the item's review priority to high.

Can I sync weak points from my learning tracker into the review schedule?▼

Yes, run the script with --sync-weak-points. It reads weak_points from learning.json, adds new ones as high-priority items, promotes existing items to high priority, and skips duplicates using normalized text comparison.

Where does the spaced repetition data get stored?▼

Review items persist in .agent/state/srs_log.json, and each save also syncs an SRS snapshot and last session date into learning.json. Both are plain JSON files you can inspect or back up.

Does the scheduler support custom initial intervals for graded answers?▼

Not yet in code. The SKILL.md documents a mapping of grading outcomes to initial due dates (D+1 to D+7), but the script currently fixes the initial interval at 1 day, so custom initial dues must be handled manually.