usmle
Prepare for US medical licensing exams with progress tracking, weak area analysis, question bank management, and residency match planning.
Best use case
usmle is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Prepare for US medical licensing exams with progress tracking, weak area analysis, question bank management, and residency match planning.
Teams using usmle should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/usmle/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How usmle Compares
| Feature / Agent | usmle | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Prepare for US medical licensing exams with progress tracking, weak area analysis, question bank management, and residency match planning.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
SKILL.md Source
## 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
Related Skills
zinc-database
Access ZINC (230M+ purchasable compounds). Search by ZINC ID/SMILES, similarity searches, 3D-ready structures for docking, analog discovery, for virtual screening and drug discovery.
zarr-python
Chunked N-D arrays for cloud storage. Compressed arrays, parallel I/O, S3/GCS integration, NumPy/Dask/Xarray compatible, for large-scale scientific computing pipelines.
xlsx
Use this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.
writing-skills
Use when creating new skills, editing existing skills, or verifying skills work before deployment
writing-plans
Use when you have a spec or requirements for a multi-step task, before touching code
wikipedia-search
Search and fetch structured content from Wikipedia using the MediaWiki API for reliable, encyclopedic information
wellally-tech
Integrate digital health data sources (Apple Health, Fitbit, Oura Ring) and connect to WellAlly.tech knowledge base. Import external health device data, standardize to local format, and recommend relevant WellAlly.tech knowledge base articles based on health data. Support generic CSV/JSON import, provide intelligent article recommendations, and help users better manage personal health data.
weightloss-analyzer
分析减肥数据、计算代谢率、追踪能量缺口、管理减肥阶段
<!--
# COPYRIGHT NOTICE
verification-before-completion
Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always
vcf-annotator
Annotate VCF variants with VEP, ClinVar, gnomAD frequencies, and ancestry-aware context. Generates prioritised variant reports.
vaex
Use this skill for processing and analyzing large tabular datasets (billions of rows) that exceed available RAM. Vaex excels at out-of-core DataFrame operations, lazy evaluation, fast aggregations, efficient visualization of big data, and machine learning on large datasets. Apply when users need to work with large CSV/HDF5/Arrow/Parquet files, perform fast statistics on massive datasets, create visualizations of big data, or build ML pipelines that do not fit in memory.