usmle
v1.0.1Prepare for US medical licensing exams with progress tracking, weak area analysis, question bank management, and residency match planning.
Installation
Please help me install the skill `usmle` from SkillHub official store.
npx skills add ivangdavila/usmle
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