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:
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
1---2name: usmle3description: Prepare for US medical licensing exams with progress tracking, weak area analysis, question bank management, and residency match planning.4---56## When to Use78User 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.910## Quick Reference1112| Topic | File |13|-------|------|14| Exam structure and scoring | `exam-config.md` |15| Progress tracking system | `tracking.md` |16| Study methods and resources | `study-methods.md` |17| Stress management and wellbeing | `wellbeing.md` |18| Residency targeting | `targets.md` |19| User type adaptations | `user-types.md` |2021## Data Storage2223User data lives in `~/usmle/`:24```25~/usmle/26├── profile.md # Goals, target score, exam dates, user type27├── steps/ # Per-step progress (step1, step2ck, step3)28├── sessions/ # Study session logs29├── assessments/ # NBME, UWorld self-assessments, practice tests30├── qbank/ # Question bank tracking (UWorld, Amboss, etc.)31└── feedback.md # What works, what doesn't32```3334## Core Capabilities35361. **Daily scheduling** — Generate study plans based on exam countdown and weak areas372. **Progress tracking** — Monitor scores, time spent, mastery levels across all organ systems383. **Weak area identification** — Analyze wrong answers to find high-ROI topics394. **Question bank management** — Track completion, percent correct, flagged questions across UWorld/Amboss/etc405. **Assessment analysis** — NBME/UWSA score interpretation with predicted three-digit score416. **Residency targeting** — Match score expectations to specialty competitiveness4243## Decision Checklist4445Before study planning, gather:46- [ ] Target Step (1, 2 CK, or 3)47- [ ] Exam date and days remaining48- [ ] User type (US MD, US DO, IMG, retaker)49- [ ] Target score range or specialty50- [ ] Current baseline (NBME/UWSA score if available)51- [ ] Resources in use (UWorld, First Aid, Anki, etc.)5253## Critical Rules5455- **ROI-first** — Prioritize organ systems with highest points-per-hour potential for this user's gaps56- **Track everything** — Log sessions, scores, wrong questions to `~/usmle/`57- **Adapt to user type** — US MDs need Step timing for M3; IMGs need score maximization for competitiveness; retakers need targeted remediation58- **Step 1 is P/F** — Since 2022, Step 1 is pass/fail. Step 2 CK score is now critical for residency59- **Question-first** — UWorld questions teach better than passive reading60- **Wellbeing matters** — Monitor for burnout; dedicated study periods are intense