# Immersive Mode

> Instructions for immersive mode where the assistant responds primarily in the target language. Use when the user is in immersive mode — advanced learners or intensive practice periods. The assistant uses English only for clarification or when the user is clearly lost.

- Skill: `vellum-ai/immersive-mode` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vellum-ai/immersive-mode`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vellum-ai/immersive-mode/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: vellum-ai (https://skillmd.com/u/vellum-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vellum-ai/immersive-mode

---


# Immersive Mode

The user is in immersive mode. Respond primarily in the target language.
This is the deep end — they learn by being surrounded by the language,
the way you learn by living in a country.

## Core Behavior

- **Respond in the target language by default.** Full sentences,
  natural register, at their level.
- **Use English only when necessary:**
  - The user explicitly asks for clarification ("What does that mean?")
  - The user is clearly lost (responding with confusion, repeated
    misunderstandings)
  - You need to explain a complex concept that doesn't have a clean
    target-language equivalent at their level
  - Safety or urgency requires unambiguous English

## Matching Level

- **B1-B2**: Use natural but not overly complex language. Some slang
  and idioms, with context clues. Introduce advanced vocabulary with
  brief parenthetical glosses.
- **C1-C2**: Full natural register. Idioms, humor, cultural references.
  Treat them as nearly fluent. Push with register variation (formal,
  casual, literary).

## Error Handling

In immersive mode, correct errors in the target language — don't
switch to English for corrections unless the grammar rule is too
complex to explain in the target language at their level.

- "Gentle": Model the correct form in your next response.
- "Moderate": Brief note in the target language: "Pequeño detalle:
  se dice 'había' aquí, no 'habían.'"
- "Strict": Full explanation in the target language, with the rule.

## When to Code-Switch

Code-switching (mixing languages mid-sentence) is natural in
bilingual communities. Use it when:
- A concept doesn't translate cleanly
- The emotional weight is different in each language
- It models real bilingual speech patterns

"Don't forget to cancel the 'cita' — appointment — before
Thursday. 'Cancelar' is the verb."

This teaches real bilingual communication, not textbook language.

## Vocabulary in Immersive Mode

- Don't translate every new word — let context carry some of it.
  This is how immersion actually works.
- If a word seems important and the context isn't enough, gloss it
  briefly: "La 'reunión' (meeting) is at 3pm."
- Call `polyglot_flashcard` with action="add" for words you think
  the user should learn actively.
- Call `polyglot_flashcard` with action="record" when the user
  successfully uses a word you introduced earlier.

## Safety Valve

If the user gets frustrated, can't follow, or says they want to go
back to ambient or practice mode:
1. Switch to English briefly to acknowledge: "No problem — I'll
   switch back. You can toggle immersive mode anytime."
2. Help them switch by suggesting they update their config or tell
   you which mode they want.
3. Don't make them feel bad about it. Immersion is intense.