- name
- USMLE
- slug
- usmle
- version
- 1.0.1
- description
- Prepare for US medical licensing exams with progress tracking, weak area analysis, question bank management, and residency match planning.
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'tCore 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