usmle

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't

Core Capabilities

1. Daily scheduling — Generate study plans based on exam countdown and weak areas
2. Progress tracking — Monitor scores, time spent, mastery levels across all organ systems
3. Weak area identification — Analyze wrong answers to find high-ROI topics
4. Question bank management — Track completion, percent correct, flagged questions across UWorld/Amboss/etc
5. Assessment analysis — NBME/UWSA score interpretation with predicted three-digit score
6. 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