hsk-learning_skill

Overview

This skill delivers a focused HSK Chinese learning system with spaced repetition mastery tracking, vocabulary exposure analysis, and adaptive quiz generation. It manages all 2,211 HSK 3.0 words and automates review scheduling and progress reporting. Use it to prioritize reviews, generate targeted quizzes, and analyze Chinese exposure in conversation logs.

How this skill works

The system maintains a per-user mastery database and a shared HSK word-to-level mapping. It scans conversation logs and quiz-performance files to tag tokens by HSK level and update mastery using an SM-2 inspired spaced repetition algorithm. Adaptive quizzes are generated from due items and configurable difficulty and format parameters.

When to use it

• Tracking HSK vocabulary progress across HSK levels 1–6
• Scheduling and managing spaced repetition reviews for HSK words
• Generating adaptive quizzes focused on due or new HSK items
• Analyzing conversation logs for HSK-level exposure and progress reporting
• Parsing quiz logs to update mastery automatically

Best practices

• Initialize the personal mastery database before first use so all words start in the correct state
• Run regular scans of conversation memory files (or schedule the cron job) to keep exposure reports current
• Process quiz logs promptly to keep spaced repetition intervals accurate
• Use get_due_words to build review sessions limited by time or level
• Prefer mixed or review quiz difficulty for balanced practice and retention

Example use cases

• Create a 20-item daily review from words due across multiple HSK levels
• Scan chat logs weekly to see which HSK words appear most and which levels need more input
• Parse a quiz-performance log after a study session to update mastery and next-review dates
• Generate a listening-format quiz for recently learned words (requires TTS for audio)
• Produce a progress report showing counts of unknown/learning/mastered by HSK level