fluent-progress

Generates a read-only language learning progress dashboard from six JSON learner databases.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Language learners lose motivation when they cannot see whether their practice is paying off. This Skill aggregates scattered learning data into a single personalized dashboard showing streaks, mastery levels, accuracy trends, and next goals. ## Core Features & Use Cases - Comprehensive Dashboard: Renders overview stats, per-skill mastery (writing, speaking, vocabulary, reading), accuracy trends, focus areas, spaced-repetition status, achievements, and session history. - Read-Only Safety: Never modifies any database file, so it is safe to auto-invoke on natural-language questions like "how am I doing" or "show my stats". - Personalized Recommendations: Derives short-, medium-, and long-term goals from weak mistake patterns, unpracticed skills, and due reviews. - Use Case: A learner asks "how am I doing with Dutch?" and immediately receives a formatted report with their current streak, vocabulary count, accuracy trend chart, and the top grammar patterns needing attention. ## Quick Start Ask the assistant "show my language learning progress" or type /fluent-progress to render your full dashboard.

Frequently Asked Questions about fluent-progress

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

FAQPage Schema
How do I see my language learning progress and stats?▼

Ask a natural-language question like "how am I doing" or "show my stats", or invoke /fluent-progress directly. The skill reads all six learner databases and renders a dashboard with mastery levels, streak, accuracy trends, and next goals.

What data does the language progress dashboard show?▼

The dashboard shows current and target level, study streak, total sessions and minutes, per-skill mastery for writing, speaking, vocabulary, and reading, accuracy trends, mistake focus areas, spaced-repetition due counts, achievements, and recent session history.

Does viewing my progress modify my learning data?▼

No. The skill is strictly read-only and never calls update-db.py or edits any JSON file in the data directory. This makes it safe to auto-invoke on ambiguous questions without risking data corruption.

Why does the progress dashboard show 'Not yet practiced' for a skill?▼

Sections with no recorded data are skipped rather than filled with fabricated numbers. If you have never practiced speaking, for example, the dashboard displays "Not yet practiced" until you complete a session targeting that skill.

What happens if my learner database files are missing?▼

If any of the six required JSON databases are missing, the skill stops and directs you to run /fluent-setup first. It resolves the data directory through fluent_paths.data_dir() rather than assuming a hardcoded path.