fluent-session-analyzer

Parse language practice session markdown files to extract error patterns and plan adaptive lessons.

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/mituso89/fluent --skill fluent-session-analyzer-mituso89
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fluent-session-analyzer
Source: https://github.com/mituso89/fluent/tree/main/.claude/skills/fluent-session-analyzer
Command: npx skills add https://github.com/mituso89/fluent --skill fluent-session-analyzer-mituso89

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Language learners accumulate session reports but lack a systematic way to turn raw feedback into targeted practice. This Skill reads recent session markdown files and converts error markers, scores, and corrections into a prioritized plan for the next lesson. ## Core Features & Use Cases - Error Pattern Extraction: Scans session files for correction markers, categorizes errors by type (grammar, vocabulary, prepositions) and severity, and counts frequency to distinguish typos from real weaknesses. - Trajectory Tracking: Compares accuracy and error counts across recent sessions to measure progress and tune difficulty. - Session Planning: Produces a structured next-session plan allocating time to top weaknesses, moderate patterns, and integration scenarios. - Use Case: Before starting a writing lesson, the tutor reviews the last three writing session reports, identifies that formal/informal register errors occurred five times, and builds a 20-minute drill sequence targeting that pattern. ## Quick Start Analyze my recent Fluent writing session results and tell me what I should practice next.

Frequently Asked Questions about fluent-session-analyzer

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

FAQPage Schema
How do I analyze language learning session results to plan practice?▼

Read the 3-5 most recent session markdown files for the relevant skill, count error patterns by category and severity, then allocate session time to the highest-frequency weaknesses. Patterns with 4 or more occurrences are critical priorities.

What file format does the session analyzer read?▼

It reads markdown reports named fluent-{skill}-session-{NNN}.md stored in the /results/ directory. Older unprefixed files in the form {skill}-session-{ID}.md from before v0.2.0 are also supported.

When should I use session file analysis instead of the JSON databases?▼

Use session file analysis when you need textual context like the exact sentence written, the scenario, or the feedback given. For counts, trends, and mastery levels, the read-db.py script against the JSON databases is preferred.

How many past sessions should be reviewed for planning?▼

Review only the 3-5 most recent sessions for the relevant skill. Older data is already consolidated into the mistakes-db.json mastery levels, so re-reading the full history adds no value.

Does the session analyzer modify my session result files?▼

No. Session files in /results/ are treated as immutable records. The analyzer only reads them for planning purposes and never alters their content.