fluent-setup

Creates a personalized language-learning profile and seeds six JSON databases through interactive onboarding.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a structured language-learning routine requires a profile, a study plan, and initialized tracking databases; doing this by hand is error-prone and every other Fluent skill depends on these files existing. ## Core Features & Use Cases - Interactive Onboarding: Collects name, target and native languages, explanation language, CEFR levels, timeline, daily minutes, goals, and learning style via guided questions. - Level Assessment: Runs a 5-question placement quiz mapping answers to CEFR levels A1 through C1 when the learner is unsure of their level. - Plan Generation: Computes estimated months and total study hours to reach the target level, with adjustments for related native languages and prior language knowledge. - Database Bootstrapping: Writes six JSON files (learner profile, progress, mistakes, mastery, spaced repetition, session log) plus a multi-language registry in the resolved data directory. - Profile Management: Handles returning users with update, view, and double-confirmed reset flows that back up data before deletion. - Use Case: A new learner types /fluent-setup, answers questions about learning Japanese from English at A2 targeting B2 in 12 months, and receives a weekly study schedule with all tracking databases initialized. ## Quick Start Type /fluent-setup and answer the onboarding questions to create your language-learning profile and personalized study plan.

Frequently Asked Questions about fluent-setup

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

FAQPage Schema
How do I set up a language learning profile in Claude Code?▼

Run /fluent-setup to start an interactive onboarding that collects your name, target language, native language, CEFR level, timeline, and daily study minutes. It then generates a personalized plan and writes six JSON tracking databases to your data directory.

How does the CEFR level assessment work during onboarding?▼

If you answer "not sure" for your current level, the skill runs a 5-question quiz covering vocabulary recognition through idiomatic expressions. Your score maps directly to a CEFR level: 0-1 correct is A1, up to 5 correct for C1.

Can I reset my language learning progress and start over?▼

Yes, returning users can choose the reset option, which requires double confirmation before deleting progress. The skill first backs up all JSON files to a timestamped .backups/pre-reset directory, then restarts the onboarding flow.

Where does Fluent store learner profile data?▼

The data directory resolves in order: $FLUENT_DATA_DIR if set, then $CLAUDE_PROJECT_DIR/data or ./data if they contain profile files, otherwise ~/.claude/fluent-data. Multi-language learners get an additional per-language subdirectory resolved automatically.

Why won't fluent-setup run automatically when I mention setup?▼

The skill is gated with disable-model-invocation: true because re-running it can reset a learner's progress. It only activates when you explicitly type /fluent-setup, never from ambiguous prompts.