Agent skill

Fluent Vocab

by m98 in m98/fluent

Run an interactive vocabulary drill session with flashcard-style prompts, spaced repetition, and per-answer feedback.

MITAuto-check: notesEducation

Install Fluent Vocab

skills CLI
$ npx skills add m98/fluent --skill fluent-vocab -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install m98/fluent fluent-vocab --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/m98/fluent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/fluent-vocab .claude/skills/fluent-vocab && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
fluent-vocab
GitHub stars
421
Token cost
~1.4k tokens
SKILL.md length
540 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

Run an interactive vocabulary drill session with flashcard-style prompts, spaced repetition, and per-answer feedback.

  • Works in 6 steps: Load vocabulary data → Select words → Present one word at a time → …
  • Tasks that involve Study guides and flashcards
  • SKILL.md covers Overview, When to Use, Instructions and Examples, plus 2 more sections
  • Calls python3

What it does

Fluent Vocab is an agent skill from m98/fluent. Run an interactive vocabulary drill session with flashcard-style prompts, spaced repetition, and per-answer feedback. Triggered only when the learner types /fluent-vocab. Reads spaced-repetition / mistakes / mastery DBs to pick words, presents one word at a time, scores each answer, and calls fluent-db-updater at the end.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Education, covering Study guides and flashcards. The repository describes itself as: The AI Language Learning Kit for Claude Code and others. The licence is MIT.

When your agent uses it

  • Tasks that involve Study guides and flashcards

Example prompts

  • “/fluent-vocab”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Read, Write, Bash

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Load vocabulary data
  2. Select words
  3. Present one word at a time
  4. Feedback after each answer
  5. Session summary
  6. Update all databases

What it can do on your machine

Read from SKILL.md and the folder at commit 86fb80f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Fluent Vocab loads about 1.4k tokens when it runs. Until then it costs about 84 tokens; SKILL.md has 540 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~84
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Bash

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from m98/fluent at commit 86fb80f, republished under its MIT licence (© m98). 540 words, ~1,435 tokens.

Download SKILL.mdSave it as .claude/skills/fluent-vocab/SKILL.md (or your agent's skills folder).
name
fluent-vocab
description
Run an interactive vocabulary drill session with flashcard-style prompts, spaced repetition, and per-answer feedback. Triggered only when the learner types /fluent-vocab. Reads spaced-repetition / mistakes / mastery DBs to pick words, presents one word at a time, scores each answer, and calls fluent-db-updater at the end.
allowed-tools
Read, Write, Bash
disable-model-invocation
true

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
bash
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):

markdown
## Word {N}/{total}

**{target_language}:** {word}

**Context:** {example_sentence}

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

**Type your answer:**

Production (native → target_language):

markdown
## Word {N}/{total}

**{native_language}:** {word}

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

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

**Type your answer:**

Cloze (fill in the blank):

markdown
## Word {N}/{total}

**Complete the sentence:**

{target_language sentence with _____ where the word goes}

**Type the missing word:**
4. Feedback after each answer

Use the fluent-feedback-formatter skill's template. Score out of 10, tag severity.

Track the answer for the end-of-session DB update:

  • Add to review_results[] with quality = floor(score / 2) (see fluent-sm2-calculator skill).
  • If the learner met a new word, stage it for new_vocabulary[].
  • If the learner made an error, stage it for errors[].

Do not call update-db.py after every word — batch at session end.

5. Session summary
markdown
## 📚 Vocabulary Session Complete!

**Words Reviewed:** {N}
**Accuracy:** {X}%
**New Words Learned:** {Y}
**Words Mastered (→ level 5):** {Z}

**Strong:** {list words with mastery 4-5}
**Need more practice:** {list words with mastery 0-2}

**Next review:**
- Tomorrow: {count} words
- This week: {count} words

{target-language "well done"}! 🌟
6. Update all databases

Call the fluent-db-updater skill's workflow — one update-db.py invocation with:

  • session_id, date, duration_minutes
  • command_used: "/fluent-vocab"
  • skills_practiced: ["vocabulary"]
  • skill_scores.vocabulary: {exercises, correct, time_minutes}
  • errors[], new_vocabulary[], review_results[] collected during the session
  • focus_next_session[] — top 2-3 weak words

Examples

Example 1 — recognition drill

Word 1/15

Dutch: de keuken

Context: "De keuken is klein maar mooi."

What does it mean in English?

Type your answer:

Learner: "the kitchen"

✅ Exactly.

Answer: the kitchen Meaning: A room used for cooking and food preparation. Example: "De keuken is klein maar mooi." (The kitchen is small but pretty.)

Score: 10/10 🎯


Show full SKILL.md (190 more words)Show less
Example 2 — production with error

Word 7/15

English: to write

How do you say this in Dutch?

Learner: "schrijven"

✅ Correct — infinitive form.

Now: can you also give the first-person present? (I write → …)

Example 3 — session end summary

📚 Vocabulary Session Complete!

Words Reviewed: 15 Accuracy: 80% (12/15) New Words Learned: 3 Words Mastered: 1

Need more practice: de sleutel, het raam, gisteren

Next review: Tomorrow 4 words, this week 8 words.

Goed gedaan! 🌟

Critical Rules

  • One word at a time. Wait for the learner's answer before showing the next.
  • Immediate feedback after each — use fluent-feedback-formatter.
  • Mix modes. Don't drill 20 recognition prompts in a row — interleave for discrimination.
  • Use target language for greetings + transitions when the learner is B1+; for A1-A2 mix target + native.
  • Never update the DBs mid-session — batch at end.
  • Never auto-invoke. This skill is gated; must fire only on explicit /fluent-vocab.

Tips for the Learner (append if they seem tired or unsure)

  • Review daily for best retention — spaced repetition depends on it.
  • Focus time on weak words (mastery 0-2), not already-strong ones.
  • Use words in sentences to build contextual memory.
  • Say words out loud even though you're typing.

© m98, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/fluent-vocab of m98/fluent.

Open the folder on GitHubat commit 86fb80f

Compare with similar skills

Fluent Vocab next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Fluent Vocab compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fluent Vocab this skillm98/fluent421—~1.4kAutomated safety check: NotesMIT
Deep Reading Analystginobefun/deep-reading-analyst-skill3534 repos~3.6kAutomated safety check: PassMIT
NihaishaJuneYaooo/nihaisha-nishi-tcm2.2k—~4kAutomated safety check: PassNone
Claude Certification Tutorrohitg00/ai-engineering-from-scratch66k—~3kAutomated safety check: PassMIT
StudyVault Quiz Tutorbevibing/tutor-skills1.3k—~1.4kAutomated safety check: PassMIT
Project Mastery Coachtudoumashu/ai-memory-skillpack443—~1.8kAutomated safety check: PassMIT

Similar skills

  • Deep Reading Analyst

    ginobefun/deep-reading-analyst-skill

    Comprehensive framework for deep analysis of articles, papers, and long-form content using 10+ thinking models (SCQA, 5W2H, critical thinking, inversion, mental models, first principles, systems…

    353 GitHub starsUsed in 4 repos~3.6k tokens
    EducationAuto-check passed
  • Nihaisha

    JuneYaooo/nihaisha-nishi-tcm

    A skill your agent uses when the user asks about Ni Haisha / 倪海厦 TCM course material, especially Shang Han Lun / 伤寒论, Jingui / 金匮要略, Zhongjing Xinfa / 仲景心法, clinical cases / 临床案例 / 倪师医案, Bagang…

    2.2k GitHub stars~4k tokensUpdated 23 days ago
    EducationAuto-check passed
  • Claude Certification Tutor

    rohitg00/ai-engineering-from-scratch

    Guides a learner through one of four independent Claude certification tracks with onboarding, lessons, practice labs, mock exams and remediation.

    66k GitHub stars~3k tokensUpdated today
    EducationAuto-check passed
  • StudyVault Quiz Tutor

    bevibing/tutor-skills

    Quizzes you on the notes in an Obsidian StudyVault, tracks proficiency per concept and drills weak areas in four-question rounds.

    1.3k GitHub stars~1.4k tokensUpdated 7 mo ago
    EducationAuto-check passed
  • Project Mastery Coach

    tudoumashu/ai-memory-skillpack

    Train strict project ownership from repo-local docs/ai memory and central LLM Wiki project entities.

    443 GitHub stars~1.8k tokensUpdated 1 mo ago
    EducationAuto-check passed
  • Turns a named classical Chinese chapter, such as one from the Tao Te Ching or the Analects, into a single annotated PNG image with notes and commentary.

    7.5k GitHub stars~551 tokensUpdated yesterday
    EducationAuto-check passed

More from m98/fluent

All 12 skills in this repo
  • Fluent Progress

    m98/fluent

    Show the learner's language learning progress, statistics, mastery levels, streak, and achievements.

    421 GitHub stars~1.5k tokensUpdated 3 mo ago
    Auto-check: notes
  • Parse Fluent /results/.md session files to extract error patterns, strengths, accuracy trends, and focus areas for the next session.

    421 GitHub stars~1.3k tokensUpdated 3 mo ago
    Auto-check passed
  • SM-2 spaced-repetition algorithm reference for the Fluent language learning system.

    421 GitHub stars~1.2k tokensUpdated 3 mo ago
    Auto-check passed
  • Atomically update all 6 Fluent learner databases (learner-profile, progress, mistakes, mastery, spaced-repetition, session-log) at session end by calling .claude/hooks/update-db.py with a single…

    421 GitHub stars~1.6k tokensUpdated 3 mo ago
    Auto-check passed
  • Canonical feedback template for every learner answer in the Fluent system — celebrate correct parts, correct mistakes with category and brief explanation, show the full correct version, score out of…

    421 GitHub stars~1.2k tokensUpdated 3 mo ago
    Auto-check passed
  • Fluent Learn

    m98/fluent

    Main adaptive language-learning session that mixes skills (writing, speaking, vocabulary, reading) and exercise types based on the learner's current level, weak patterns, and due reviews.

    421 GitHub stars~1.8k tokensUpdated 3 mo ago
    Auto-check: notes

Categories

Questions about Fluent Vocab

What does Fluent Vocab do?

Run an interactive vocabulary drill session with flashcard-style prompts, spaced repetition, and per-answer feedback. Fluent Vocab is an agent skill from m98/fluent. Run an interactive vocabulary drill session with flashcard-style prompts, spaced repetition, and per-answer feedback.

When should I use Fluent Vocab?

Fluent Vocab fits situations like: tasks that involve Study guides and flashcards.

How do I install Fluent Vocab in Claude Code?

Run `npx skills add m98/fluent --skill fluent-vocab -a claude-code`. Or copy the skill folder (.claude/skills/fluent-vocab in m98/fluent) into .claude/skills/fluent-vocab in your project. Claude Code loads it when a task matches its description.

How do I install Fluent Vocab in Codex?

Run `npx skills add m98/fluent --skill fluent-vocab -a codex`. Or copy the skill folder (.claude/skills/fluent-vocab in m98/fluent) into .agents/skills/fluent-vocab in your project. Codex loads it when a task matches its description.

Can I use Fluent Vocab in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add m98/fluent --skill fluent-vocab -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/fluent-vocab, .gemini/skills/fluent-vocab, .github/skills/fluent-vocab and .opencode/skills/fluent-vocab in your project.

What does Fluent Vocab need to run?

Going by SKILL.md and its folder, Fluent Vocab needs the command-line tools its instructions call (python3). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Read, Write, Bash.

Does Fluent Vocab access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Fluent Vocab safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Fluent Vocab use?

Fluent Vocab is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Fluent Vocab use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Fluent Vocab?

Skills that share tags, products or a category with Fluent Vocab: Deep Reading Analyst (ginobefun/deep-reading-analyst-skill, 353 stars), Nihaisha (JuneYaooo/nihaisha-nishi-tcm, 2.2k stars), Claude Certification Tutor (rohitg00/ai-engineering-from-scratch, 66k stars) and StudyVault Quiz Tutor (bevibing/tutor-skills, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fluent Vocab?

m98 (a GitHub user) maintains it in m98/fluent, which has 421 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on June 15, 2026.

Source: m98/fluent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.