fluent-review

Runs daily SM-2 spaced-repetition review sessions with exercise generation and queue updates.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/xiaoshan1234/ai-skill --skill fluent-review-xiaoshan1234
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fluent-review
Source: https://github.com/xiaoshan1234/ai-skill/tree/main/role/english-teacher/skills/fluent-review
Command: npx skills add https://github.com/xiaoshan1234/ai-skill --skill fluent-review-xiaoshan1234

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Language learners forget vocabulary and grammar unless they review items at the right moment. This Skill runs the daily spaced-repetition review queue, pulling items scheduled by the SM-2 algorithm, testing the learner on each one, and rescheduling items based on performance so nothing slips through the forgetting curve. ## Core Features & Use Cases - Due-Item Queue Loading: Reads spaced-repetition.review_queue.today, sorts by priority (critical to low), and caps the session at the daily item limit. - Adaptive Exercise Generation: Creates targeted exercises per item type — error patterns, vocabulary (recognition, production, cloze), and grammar rules — presented one at a time. - SM-2 State Updates: Scores each answer, maps it to a quality value, and passes review_results[] to the database updater which recalculates easiness factors, intervals, and repetitions. - Use Case: A Dutch learner types /fluent-review each morning. The Skill presents 12 due items, evaluates each answer with feedback, and reschedules mastered items weeks out while missed items return tomorrow. ## Quick Start Type /fluent-review to start today's spaced-repetition review session and work through each due item one at a time.

Frequently Asked Questions about fluent-review

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

FAQPage Schema
How do I run a spaced repetition review session?▼

Type /fluent-review to start the session. The Skill loads items due today from the review queue, sorts them by priority, and presents one exercise at a time until the daily limit is reached.

How does the SM-2 algorithm schedule language reviews?▼

SM-2 assigns each item an easiness factor, interval, and repetition count. Correct answers multiply the interval by the easiness factor; wrong answers reset repetitions and bring the item back the next day.

What happens if the review queue is empty?▼

The Skill reports that no reviews are due and suggests alternatives like /fluent-learn for adaptive practice or /fluent-vocab for new words, rather than running an empty session.

Can I edit the spaced-repetition.json file manually?▼

No. The queue is rebuilt on every update-db.py call, so manual edits are overwritten. All changes must go through the review_results payload passed to the database updater.

Why does the skill not trigger automatically?▼

It is gated with disable-model-invocation because it mutates SM-2 state. An accidental trigger from a misread prompt would corrupt scheduling data and cascade through every future session.