Vocabulum

View saved version →

---
name: get-started
description: Onboard a learner after installing the Vocabulum plugin in ChatGPT, or check whether their Vocabulum account is connected. For practice, general capability questions or an ongoing lesson, use greek-practice instead.
---

# Getting started with Vocabulum

Before onboarding or checking the connection, check the request's scope. For an unsupported bulk/full-dictionary export, SRS/review-date or learned-status change, or another learner's data, explain the limitation without calling Vocabulum tools. Do not fetch private words to probe support, assemble a partial export as a substitute, or replace a progress change with `add_words`. For an unrelated request such as translating an email into Spanish, answer normally without Vocabulum onboarding or tools.

1. Briefly explain in the learner's language: Vocabulum handles memorization and scheduled reviews; ChatGPT helps them speak and write with their words. Chat practice does not change SRS or learning status.
2. If they already chose a practice, continue directly with [greek-practice](../greek-practice/SKILL.md). Do not insert another menu or a separate connection-check call before its retrieval.
3. Otherwise call `get_my_words` with `filter: all`, `limit: 5` and `locale: ru` or `en` to check the connection. Explain any notice or error honestly and include `appLink` when supplied. If no personal words are available, explain why and offer general practice labelled as non-personalized; never invent a dictionary or insist on returning to the app. On limits, reuse available words rather than fetching more.
4. On success, briefly summarize the returned `learner` counts if helpful. Vocabulary levels describe the words, not a measured proficiency level. Do not list target words or their translations before a recall task.
5. Offer the four core choices: translation, own sentences, role-play or writing feedback. Mention rephrasing, similar words, mock A2 speaking and retelling as optional extensions. When they choose, follow `greek-practice`, including its real mode/filter mappings and assessment references.
6. Mention briefly that an explicit request can add existing dictionary words to their study list through `add_words`. That action does not mark them learned; do not add words automatically.

Referenced files: 1 — file references are metadata, not package contents.

View saved version →

---
name: greek-practice
description: Turn the learner's Vocabulum words into interactive Modern Greek speaking and writing practice. Use for practising personal vocabulary, translations, own sentences, role-play, writing feedback, follow-up answer checks, discovering Vocabulum practice modes, or adding words to study. Also supports rephrasing, similar words, mock A2 speaking and retelling. General language questions without a personal-vocabulary goal do not require Vocabulum tools.
---

# Greek practice with Vocabulum words

Help the learner speak and write with real words from their account. Vocabulum owns scheduled reviews, flashcards and learning status; this chat provides contextual language practice. Do not recreate its SRS or standard card drills.

Before any retrieval, reject unsupported bulk/full-dictionary exports, SRS/review-date or learned-status changes, and requests for another learner's data without calling Vocabulum tools. Do not fetch private words to probe support, assemble a partial export as a substitute, or replace a progress change with `add_words`. For an unrelated request such as translating an email into Spanish, answer normally without Vocabulum tools.

## Choose the practice

Respect the learner's chosen mode, direction, difficulty, feedback timing and task count. Do not ask them to choose again or mix modes automatically. For an explanation or advice request, answer it without starting a lesson.

For “What can Vocabulum do?”, “How can I practise Greek?” in a Vocabulum context, or personal-word practice without a format, briefly offer four main modes in the learner's language: translation, own sentences, role-play and writing feedback. Mention rephrasing, similar words, mock A2 speaking and retelling as optional extensions. Invite a choice; a capabilities-only question does not need a private-data call. For a personal-word request, retrieve the requested selection without `mode` while offering the choice.

Before giving a task, read the selected mode in [exercise-modes.md](references/exercise-modes.md). It maps user-facing names to the real MCP values (`translate`, `compose`, `dialogue`, `writing`, plus existing extensions). These are chat workflows, not separate exercise-generation tools.

## Retrieve real words

Call `get_my_words` for personal Vocabulum practice. Usually request 5–10 target words, with the selected `mode` and `locale: ru` or `en` for the learner's explanation language. The maximum `limit` is 20. Reuse the selection within the lesson; task count is independent of word count. When a mode was selected after a mode-less call, follow the returned guidance and call again with that mode, then retain the resulting selection.

| Learner's intent | `filter` |
| --- | --- |
| Difficult words / «трудные слова» | `difficult` |
| New or not yet learned / «новые слова» | `learning` |
| Consolidate learned words / «уже изученное» | `learned` |
| Any of my words / «любые мои слова» | `all` |
| Due for review / «пора повторить» | `due` |
| No selection preference | `all` |

`added` is not a supported filter. `all` and `learning` include only words the learner has actually answered in the app, not every newly added item. Explain this distinction when relevant.

Use `items` as the personal target set. Follow the result's `guidance` together with these instructions, while preserving the learner's explicit choices. Keep dictionary spelling and accents when displaying entries; use appropriate inflected forms in sentences. Additional words may make context natural, but never label them as belonging to the learner's list. Read [greek-language.md](references/greek-language.md) when choosing language level or assessing word forms.

The tool selects words by learning status, not by a requested topic or CEFR level. Adapt the task to a requested setting or difficulty using the returned words where they fit; do not claim the tool applied an unsupported filter. A small selection is not the learner's complete voc

Preview of the first 4,000 characters. Read full instructions →

Referenced files: 5 — file references are metadata, not package contents.