english-exam-coach

Use when the user asks to prepare for, practice, or learn about an English exam (IELTS, TOEFL iBT, B1 Preliminary, B2 First, C1 Advanced, C2 Proficiency) without naming a specific task — e.g. "help me prepare for TOEFL", "what's in the C1 Advanced reading paper?", "test my English level". Resolves exam + CEFR level + section, explains formats from reference data, runs a quick level diagnostic, and hands off to the matching macro-skill (writing-evaluator, speaking-coach, reading-use-of-english, listening-trainer, vocabulary-builder, study-planner).

Use when the user wants to practice English exam listening (IELTS parts 1-4, TOEFL iBT conversations, announcements, academic talks and listen-and-choose-a-response items, B1-C2 listening parts). Generates an original script with exam-format questions, delivers it as audio when a local TTS is available (macOS `say`) or as a read-once/partner-read script otherwise, scores answers, explains them with script evidence, and logs the attempt. Also builds questions for user-provided audio or transcripts (podcasts, lectures).

Use to log a completed exam-practice attempt or to generate a progress report. Call it right after any writing/speaking/reading/listening/ vocabulary task is scored to append the result, and when the user asks to see results or trends ("show my progress", "session report", "how am I doing on writing", "what's my weakest task?"). Reads and appends to the user's progress directory ($EXAM_COACH_HOME or ~/english-exam-coach/); the log is append-only.

Use when the user wants to practice English exam reading or use-of-english tasks: IELTS (matching headings, True/False/Not Given, Yes/No/Not Given, matching information, sentence/summary completion, short answer, multiple choice), TOEFL iBT reading (complete-the-words cloze, daily-life texts, short academic passages), or B1-C2 tasks (reading-comprehension multiple choice, open cloze, multiple-choice cloze, gapped text, multiple matching; cross-text matching at C1; plus key word transformation and word formation in the B2-C2 exams only). Generates an original passage and items, scores answers objectively, explains every answer, and logs the attempt with score and time.

Use when the user wants to practice English exam speaking (IELTS Parts 1-3, TOEFL iBT speaking tasks, B1-C2 interview/long turn/collaborative tasks), wants a speaking prompt or cue card, or wants feedback on a spoken answer provided as a transcript, self-recording description, or audio file. Generates original tasks in the exam's format with real timings and gives criteria-based feedback (fluency, coherence, lexis, grammar, pronunciation) with a range estimate and CEFR level. Logs every scored attempt.

Use when the user wants a preparation plan for an English exam ("I take TOEFL on September 12, make me a plan", "how should I prepare for C1 Advanced in 8 weeks?"), wants to adjust an existing plan, or asks whether they are on track. Takes target exam, exam date, current level and weekly time budget; produces a week-by-week schedule saved to the user's progress directory and checks progress against the log.

Use when the user wants to learn, review, or be quizzed on English vocabulary for exams: leveled word sets (B1-C2), collocations, academic vocabulary, phrasal verbs, or spaced-repetition review of previously studied items ("quiz me on my words", "new C1 vocabulary", "review my vocab"). Maintains a Leitner-box review state on disk and logs quiz results to the progress log.

Use when the user wants feedback on English exam writing (IELTS Task 1/2, TOEFL email, academic-discussion, and build-a-sentence tasks, B1–C2 essays, emails, letters, articles, reports, reviews, proposals) or wants an original writing prompt in a specific exam format. Evaluates against paraphrased public CEFR descriptors and the exam's criteria structure; returns a band/score estimate as a range, a CEFR level, and prioritized rewrites drawn from the user's own text. Logs every scored attempt.