Til review

Skill SongYunSeop/oh-my-til/skills/til-review

SRS-based TIL review session (spaced repetition). Use when the user says 'quiz me', 'review what I learned', 'flashcard session', 'test my knowledge', or wants to do spaced repetition review of their TIL notes.From its SKILL.md

Install

npx -y skills add SongYunSeop/oh-my-til --skill til-review

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.6 KB, as published. Nobody here has run it

Review Skill

SRS (spaced repetition) based TIL review session. Manages review schedule with the SM-2 algorithm.

MCP Tools

til_review_list: List of cards due for review today + stats (load note content with include_content: true)
til_review_update: Record review result (grade 0-5) or remove from review

Step 1: Load Review Cards

Call til_review_list (include_content: true, pass category argument if provided).

0 cards → Show "No reviews today" + suggest registering untracked TILs (go to Step 5)
Cards found → Display list + proceed to Step 2

Step 2: Select Evaluation Mode

Select via AskUserQuestion:

"Simple mode (Again / Good)"
"Detailed mode (Again / Hard / Good / Easy)"

Step 3: Per-Card Review Loop

For each card:

Display title, category, review info (repetition count, EF, days overdue)
Use content already loaded in Step 1 (no additional MCP calls needed)
Present key content as questions (generate 1-2 questions based on content)
Wait for user answer
Provide feedback (correct answer / supplementary explanation)
Input evaluation via AskUserQuestion:
- Simple mode: "Good (Remembered)" / "Again (Forgot)" / "Skip" / "Stop Review"
- Detailed mode: "Again (Failed)" / "Hard (Struggled)" / "Good (Normal)" / "Easy (Perfect)"
- Grade mapping: Again=1, Hard=3, Good=4, Easy=5
- "Skip": do not evaluate this card, move to next
- "Stop Review": move to Step 4
- Skip/Stop in detailed mode: select "Other" then type "Skip" or "Stop Review"
If not skipped, call til_review_update (action: "review", grade)
Display result summary (next review date, interval)

Step 4: Completion Stats

After all cards are done:

Number of cards reviewed, average grade
If remaining > 0, show "N more remaining, continue tomorrow"
Re-call til_review_list to display latest stats

Step 5: Register TILs (Optional)

When no cards exist or user requests:

Display full TIL list via til_list
User selects files to add to review
Call til_review_update (action: "review", grade: 4) for each selected file

Rules

Max 20 cards per session (prevent overload)
Prioritize overdue cards (most urgent first)
Remove from review: if user says "remove this card", call til_review_update (action: "remove")