An intelligent, adaptive Spanish learning Skill for Claude
CEFR Levels: A1 → A2 → B1 → B2
Environment: Claude Desktop app, Claude Web, Claude Code
Maestro is an interactive Spanish language teacher that transforms Claude into your personal language tutor. Unlike traditional language apps with static content, Maestro combines structured curriculum with AI-powered adaptation, using web search to fetch authentic Spanish materials and tracking your progress through spaced repetition algorithms.
- 52-Week Structured Curriculum - Comprehensive lessons from beginner (A1) to upper-intermediate (B2)
- AI-Powered Adaptation - Dynamically adjusts difficulty based on your performance
- Real-World Content - Uses web search to fetch authentic Spanish materials (menus, news, rental listings)
- Progress Tracking - Spaced repetition, analytics, and personalized weekly reports
- Interactive Practice - Role-plays, conversations, and scenario-based learning
- Regional Awareness - Learn both Spain Spanish and Mexican/Latin American variants
- Data-Driven Learning - Python scripts for vocabulary tracking, progress analysis, and content generation
| Traditional Apps | Maestro |
|---|---|
| Fixed lessons | Adapts to YOUR progress |
| Static content | Live web content |
| Grammar drills | Interactive scenarios |
| One-size-fits-all | Personalized feedback |
| No memory | Spaced repetition tracking |
| Single variant | Spain + Mexico + LA |
Open the setting from Claude Desktop app or from Web and simply upload the skill file "maestro.skill". That's All !
# Navigate to the maestro directory
cd maestro
# Install Python dependencies
pip install -r requirements.txt
# or with uv:
uv pip install -r requirements.txt# Create your personal learning directory
mkdir -p ~/spanish-learning/{weekly_reports,practice_materials/{news,dialogues,exercises}}
# Copy the progress template
cp maestro/progress_template.md ~/spanish-learning/progress.mdOpen Claude Desktop app/Claude Web or Claude Code and say:
Suggestion: Create a project and put all your Spanish learning chats in that project if you choose to use Claude Desktop app or Claude web.
"我想开始学习西班牙语"
or
"I want to start learning Spanish"
Maestro will automatically activate and begin your initial assessment!
Yes.
In tools like ChatGPT, Gemini Desktop/Web App or their CLIs (Codex CLI, Gemini CLI, etc.), you can either:
- upload the entire skill as attachments, or
- extract the
maestrofolder and point the agent/CLI to that directory.
For best results, use this skill inside features like Claude or ChatGPT Projects, which provide better control over context and conversation history.
Claude desktop/web and Claude Code also support Skills natively and can keep this skill running with dynamic context management.
- Greetings, introductions, basic conversations
- Present tense verbs, daily routines
- Numbers, time, dates
- Goal: Handle basic daily interactions
- Past tenses (preterite, imperfect)
- Future tense, comparisons
- Weather, commands, preferences
- Goal: Describe experiences and events
- Subjunctive mood (all contexts)
- Conditional, hypotheticals
- Perfect tenses, complex sentences
- Goal: Independent communication
- Advanced subjunctive, passive voice
- Idioms, register, style
- Argumentation, nuanced expression
- Goal: Fluent, spontaneous, sophisticated communication
Follow the 52-week curriculum with daily lessons:
- Say "开始今天的课程" or "继续学习"
- Maestro loads your current week/day from progress.md
- Interactive teaching with practice exercises
- Progress automatically tracked
Practice specific topics on-demand:
- Say "我想练习在餐厅点餐" or "帮我复习subjunctive"
- Maestro adapts to your current level
- Uses web search for authentic materials
- Immediate feedback and corrections
- Opening (5 min) - Review previous lesson
- Objectives (2 min) - Today's goals
- Teaching (10-15 min) - New content with examples
- Practice (20-30 min) - Interactive exercises and role-plays
- Closing (5 min) - Summary and progress update
- Day 1-4: New content + practice
- Day 5: Assessment + regional differences comparison
Maestro searches the web for authentic Spanish materials:
- Real restaurant menus (current prices!)
- Actual news articles
- Rental listings
- Social media posts
- Cultural events
Built-in vocabulary tracking with spaced repetition algorithm:
# Check words due today
python scripts/vocab_tracker.py --due-today
# Add new words
python scripts/vocab_tracker.py --add "estar,ubicación,emoción"
# View statistics
python scripts/vocab_tracker.py --statsLearn both Spain and Mexico/Latin American Spanish:
- Vocabulary differences: "ordenador" (Spain) vs "computadora" (Mexico)
- Grammar: "vosotros" (Spain) vs "ustedes" (Mexico/LA)
- Pronunciation patterns
- Cultural context
Every 5th day includes assessment:
- Grammar, vocabulary, fluency, comprehension
- Detailed feedback with specific examples
- Track progress over time
- Advance when ready (3 consecutive assessments ≥80/100)
Casual learner (3-4 sessions/week, 30-45 min each):
- A1 completion: ~3-4 months
- A2 completion: ~6-8 months
- B1 completion: ~12-15 months
- B2 completion: ~18-24 months
Intensive learner (daily sessions, 1 hour each):
- A1 completion: ~6-8 weeks
- A2 completion: ~3-4 months
- B1 completion: ~6-8 months
- B2 completion: ~10-12 months
Manages spaced repetition for vocabulary learning:
- Tracks when words need review
- Adjusts intervals based on performance
- Generates review lists
- Provides mastery statistics
Analyzes learning patterns and generates reports:
- Weekly progress reports
- Identifies weaknesses and patterns
- Predicts level advancement
- Visualizes learning curve
Note: This script is currently not implemented. Claude uses WebSearch tool directly during lessons to fetch authentic Spanish content in real-time. Available as an extension point for users who need batch content fetching.
Note: This script is currently not implemented. Claude generates exercises dynamically during lessons based on your progress. Available as an extension point for users who need pre-generated exercise sets.
- Interactive, not passive - Constant dialogue, not lectures
- Spiral learning - Assess → Plan → Teach → Test → Feedback → Repeat
- Practical focus - Real-world usage over academic grammar
- Data-driven - Track progress, identify patterns, optimize
- Authentic materials - Current, real Spanish content
- Cultural competence - Language + culture together
- Practice consistently (even 20 min/day is better than 3 hours once/week)
- Speak out loud during practice
- Review vocabulary daily using spaced repetition
- Ask questions when confused
- Embrace mistakes as learning opportunities
- Use Spanish outside lessons (music, movies, apps)
- Don't rush through lessons just to "finish"
- Don't skip assessments (they identify gaps)
- Don't fear making errors in practice
- Don't compare your pace to others
- Don't study only grammar without speaking
Upon completing B2, you will be able to:
- Interact fluently with native speakers
- Understand complex texts and implicit meanings
- Participate in professional meetings
- Write sophisticated essays and reports
- Function independently in Spanish-speaking environment
- Live, work, or study in Spain/Latin America!
- Your questions → Maestro answers: 中文 (Chinese)
- Grammar explanations: 中文
- Teaching content: 西语 + 英语 for clarity
- Example sentences: 西语 + 英语
- Your practice: 西语 (Spanish)
- Corrections: 西语 + 中文 explanation
- Claude Desktop app/Web, Claude Code - This skill is designed specifically for Claude environment
- Python 3.7+ - For helper scripts
- Internet connection - For fetching authentic web content
- Git - For version control and updates
Python dependencies:
- requests
- beautifulsoup4
- markdownify
- python-dateutil
- pyyaml
- Ask Maestro: "我有个问题..."
- Request clarification: "请再解释一遍"
- Ask for examples: "给我一些例子"
- Check QUICKSTART.md for setup help
- Verify
~/spanish-learning/progress.mdexists and is writable - Ensure Python dependencies are installed
- Initial release
- Complete A1-B2 curriculum (52 weeks)
- Two working Python scripts (vocab_tracker, progress_analyzer) + two placeholder scripts (content_fetcher, practice_generator)
- Progress tracking and spaced repetition
- Regional variations support (Spain, Mexico, LA)
- Web content integration
- Interactive assessment system
Created by: Joe (with Claude's assistance) Framework: CEFR (Common European Framework of Reference for Languages) Methodology: Communicative language teaching, spaced repetition research For: Personal use and learning
"El viaje de mil millas comienza con un paso." (The journey of a thousand miles begins with one step.)
Open Claude Desktop app/Web or Claude Code and say:
"Hola, Maestro. 我准备好学习西班牙语了！"
¡Vamos! Let's go! 加油！
Maestro - Your personal Spanish teacher, powered by AI 🤖🇪🇸