fluent-vocab

Vocabulary Drill Session

Overview

Flashcard-style vocabulary practice using spaced repetition. One word at a time, immediate feedback, DB update at the end. Interleaves three modes (recognition, production, cloze) to force active recall rather than passive re-reading.

When to Use

Trigger this skill only when the learner types /fluent-vocab. The skill is gated with disable-model-invocation: true — a false-positive auto-trigger would launch a 15-min interactive session and mutate 6 JSON databases. Not worth the risk.

Skip this skill if no vocabulary items are due and no new words are queued — offer /fluent-review or /fluent-learn instead.

Instructions

1. Load vocabulary data

python3 "${CLAUDE_PLUGIN_ROOT:-${CLAUDE_PROJECT_DIR:-.}}/.claude/hooks/read-db.py"

If the helper is unavailable, resolve <data_dir> via fluent_paths.data_dir() then read:

• <data_dir>/spaced-repetition.json
• <data_dir>/mistakes-db.json
• <data_dir>/mastery-db.json
• <data_dir>/learner-profile.json (for target_language, name, level)

If any are missing, direct the learner to /fluent-setup and stop.

2. Select words

Priority order:

1. Items in spaced-repetition.review_queue.today with item_type == "vocabulary".
2. Words from mistakes-db.json where category == "vocabulary" and mastery_level <= 2.
3. New high-frequency words matching learner-profile.focus_areas.

Limit: spaced-repetition.daily_limits.review_items_per_day (default 20).

3. Present one word at a time

Rotate the three modes so the session is not monotonous.

Recognition (target_language → native):

## Word {N}/{total}

**{target_language}:** {word}

**Context:** {example_sentence}

**What does it mean in {native_language}?**

**Type your answer:**

Production (native → target_language):

## Word {N}/{total}

**{native_language}:** {word}

**Use it in a sentence (optional).**

**How do you say this in {target_language}?**

**Type your answer:**