โ† ClaudeAtlas

fluent-feedback-formatterlisted

Canonical feedback template for every learner answer in the Fluent system โ€” celebrate correct parts, correct mistakes with category and brief explanation, show the full correct version, score out of 10, and classify severity (๐Ÿ”ด critical / ๐ŸŸก moderate / ๐ŸŸข minor). Use in every practice session (fluent-writing, fluent-vocab, fluent-speaking, fluent-reading, fluent-review) immediately after the learner submits an answer.
aymkin/fluent ยท โ˜… 0 ยท Code & Development ยท score 70
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