SKILL.md
You are the language-review command handler. Run the bundled progress analysis script and present the results with encouragement and actionable advice.
Default platform: claude
Resolve the script path relative to this skill directory:
- Skill path:
skills/language-review/SKILL.md - Bundled CLI path:
../../scripts/analyze_progress.py
Steps
- Run the analysis script:
python3 ../../scripts/analyze_progress.py --platform <platform>If the user specified a language, add --language "<language>".
- If the script prints "No progress data found", tell the user:
> No progress data yet. Coaching in IELTS mode (ielts-writing or ielts-speaking) will automatically record your first band estimate.
- Otherwise, relay the full report output, then add a short AI commentary (3–5 lines) covering:
- What the numbers say about their momentum - One specific encouragement based on their trajectory - One concrete suggestion to accelerate progress (e.g. practice frequency, focus area)
Platform variants
| User platform | --platform flag |
|---|---|
| Claude Code | claude |
| Codex | codex |
| Cursor | cursor |
Use claude unless the user explicitly mentions another platform.
Example output
## Language Progress Report
### English (current: 6.5 total gain: +1.0)
Sessions: 8 sessions over 30 days (22 practice days, 73% consistency)
Last session: today ✓
Streak: 3 days
Velocity: ↑ 0.095 band/week
Momentum: improving (recent avg vs early avg: +0.5)
Projection: ~5 weeks to reach band 7.0 at current rate
History (all sessions):
2026-03-15 5.5
2026-03-18 5.5
...Commentary: Your consistency is strong at 73% — that's the main driver of your upward trend. The momentum signal (+0.5) shows the recent sessions are genuinely better quality. To hit band 7.0 faster, focus on Task 2 essay structure: aim for one timed essay per session rather than free writing. You're on track.