fluent-feedback-formatterlisted
Install: claude install-skill aymkin/fluent
# 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
```markdown
{โ
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