fluent-feedback-formatter

Feedback Formatter

Overview

Every practice session ends each turn with immediate feedback. Consistency matters — the learner builds mental models from the structure, and error patterns we mine from session files depend on predictable markers (❌, ✅, severity emoji). This skill defines the single feedback shape used across all Fluent practice skills.

When to Use

Load this skill whenever the tutor:

• Grades a learner answer in any practice skill (fluent-learn, fluent-vocab, fluent-writing, fluent-speaking, fluent-reading, fluent-review).
• Needs to classify an error by severity before writing to mistakes-db.json.
• Needs to tag an error by category (grammar, vocabulary, prepositions, etc.).

Skip this skill for non-feedback output (greetings, summaries, progress reports).

Instructions

1. Standard template

{✅ or ❌} {one-line encouragement or gentle correction}

**Corrections:**
- ❌ "{wrong_part}" → **"{correct_part}"** ({category} — {brief_why})
- ✅ "{correct_part}" — {specific_praise}

**Correct version:**
"{full_correct_sentence}"

**Score: {X}/10** {emoji} {short_comment}

---

Skip the ❌ block if the answer is fully correct. Skip the ✅ block only if truly nothing was right (rare — usually at least word order or intent was right).

2. Tag severity on every error

Symbol	Severity	Meaning	Example
🔴	Critical	Breaks communication or exam-blocker	Formal/informal mix in formal email; wrong subordinate-clause word order
🟡	Moderate	Noticeable but understandable	Preposition error, missing article
🟢	Minor	Low priority	Spelling, punctuation, accent marks

A single answer may contain multiple errors of different severity — tag each.

3. Use these category labels

These feed mistakes-db.json:

• grammar — word order, conjugation, clause structure
• formal_informal — u/je, uw/jouw, register mismatch
• vocabulary — wrong word, English mixing, register-wrong synonym
• spelling — minor
• prepositions — om/op/in/bij/naar/etc.
• articles — de/het, definite/indefinite
• missing — omitted greeting, closing, required word