fluent-feedback-formatter

Formats language learner feedback with corrections, severity tags, categories, and scores.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/xiaoshan1234/ai-skill --skill fluent-feedback-formatter-xiaoshan1234
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fluent-feedback-formatter
Source: https://github.com/xiaoshan1234/ai-skill/tree/main/origin/fluent-feedback-formatter
Command: npx skills add https://github.com/xiaoshan1234/ai-skill --skill fluent-feedback-formatter-xiaoshan1234

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Language tutors and AI practice sessions produce inconsistent feedback, which breaks learner mental models and makes session files impossible to parse for error mining and spaced repetition. This Skill enforces one canonical feedback template across every Fluent practice session. ## Core Features & Use Cases - Standardized Feedback Template: Renders every graded answer with celebration of correct parts, corrections with category and explanation, the full correct version, and a score out of 10. - Severity Classification: Tags every error as critical (🔴), moderate (🟡), or minor (🟢) to drive spaced-repetition priority. - Error Categorization: Labels mistakes with fixed categories (grammar, formal_informal, vocabulary, spelling, prepositions, articles, missing) that feed mistakes-db.json. - Use Case: After a learner submits a Dutch writing exercise in a fluent-writing session, grade the answer with the template, tag each error's severity and category, score it, and hand the score to the SM-2 calculator. ## Quick Start Grade my Dutch sentence using the standard feedback template with severity tags, error categories, and a score out of 10.

Frequently Asked Questions about fluent-feedback-formatter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I give consistent feedback on language learner answers?▼

Use a fixed feedback template that opens with encouragement, lists each correction with category and brief explanation, shows the full correct version, and ends with a score out of 10. Consistent structure lets learners scan fixes and keeps session files parseable.

How do I classify language errors by severity for spaced repetition?▼

Tag each error as critical (breaks communication), moderate (noticeable but understandable), or minor (spelling, punctuation). Severity tags drive spaced-repetition priority, so critical errors resurface sooner in review sessions.

What error categories should a language tutor track?▼

Track grammar, formal_informal register, vocabulary, spelling, prepositions, articles, and missing elements. Fixed category labels keep a mistakes database clean so error patterns can be mined across sessions.

When should this feedback template not be used?▼

Skip the template for non-feedback output such as greetings, session summaries, and progress reports. It applies only when grading a learner answer or classifying an error before writing to the mistakes database.

How does the feedback score connect to spaced repetition?▼

After scoring an answer out of 10, convert it to SM-2 quality with quality = floor(score / 2) and pass it to the SM-2 calculator skill. This updates the review schedule for the practiced item.