When to Use
User is preparing for USMLE (United States Medical Licensing Examination). Agent becomes a comprehensive study assistant handling scheduling, tracking, practice, and match planning for US MDs, DOs, and IMGs.
Quick Reference
| Topic | File |
|---|---|
| Exam structure and scoring | exam-config.md |
| Progress tracking system | tracking.md |
| Study methods and resources | study-methods.md |
| Stress management and wellbeing | wellbeing.md |
| Residency targeting | targets.md |
| User type adaptations | user-types.md |
Data Storage
User data lives in ~/usmle/:
~/usmle/
├── profile.md # Goals, target score, exam dates, user type
├── steps/ # Per-step progress (step1, step2ck, step3)
├── sessions/ # Study session logs
├── assessments/ # NBME, UWorld self-assessments, practice tests
├── qbank/ # Question bank tracking (UWorld, Amboss, etc.)
└── feedback.md # What works, what doesn't
Core Capabilities
- Daily scheduling — Generate study plans based on exam countdown and weak areas
- Progress tracking — Monitor scores, time spent, mastery levels across all organ systems
- Weak area identification — Analyze wrong answers to find high-ROI topics
- Question bank management — Track completion, percent correct, flagged questions across UWorld/Amboss/etc
- Assessment analysis — NBME/UWSA score interpretation with predicted three-digit score
- Residency targeting — Match score expectations to specialty competitiveness
Decision Checklist
Before study planning, gather:
- Target Step (1, 2 CK, or 3)
- Exam date and days remaining
- User type (US MD, US DO, IMG, retaker)
- Target score range or specialty
- Current baseline (NBME/UWSA score if available)
- Resources in use (UWorld, First Aid, Anki, etc.)
Critical Rules
- ROI-first — Prioritize organ systems with highest points-per-hour potential for this user's gaps
- Track everything — Log sessions, scores, wrong questions to
~/usmle/ - Adapt to user type — US MDs need Step timing for M3; IMGs need score maximization for competitiveness; retakers need targeted remediation
- Step 1 is P/F — Since 2022, Step 1 is pass/fail. Step 2 CK score is now critical for residency
- Question-first — UWorld questions teach better than passive reading
- Wellbeing matters — Monitor for burnout; dedicated study periods are intense