reporting-ultrasound-studies
Structures ultrasound interpretation with measurement protocols and ACR guidelines. Use when reading ultrasound exams, documenting sonographic findings, or creating US reports.
Best use case
reporting-ultrasound-studies is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Structures ultrasound interpretation with measurement protocols and ACR guidelines. Use when reading ultrasound exams, documenting sonographic findings, or creating US reports.
Teams using reporting-ultrasound-studies 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/reporting-ultrasound-studies/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How reporting-ultrasound-studies Compares
| Feature / Agent | reporting-ultrasound-studies | 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?
Structures ultrasound interpretation with measurement protocols and ACR guidelines. Use when reading ultrasound exams, documenting sonographic findings, or creating US reports.
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.
SKILL.md Source
# Reporting Ultrasound Studies Structures ultrasound interpretation with measurement protocols and ACR guidelines. ## Why This Skill Exists Ultrasound is the primary imaging modality for obstetric evaluation, thyroid assessment, testicular pathology, hepatobiliary disease, and vascular studies. Unlike CT or MRI, ultrasound is operator-dependent — the quality of the study depends heavily on the sonographer's technique. The interpreting radiologist must assess both the sonographic findings and study completeness. ACR Practice Parameters mandate that reports include specific measurement protocols per organ system, standardized terminology (e.g., TI-RADS for thyroid nodules), and explicit technical-adequacy statements. Failure to apply standardized classification systems or recommend appropriate follow-up is a documented source of diagnostic error and malpractice liability. The real-time, dynamic nature of ultrasound means that subtle findings may only be captured in select images. Reports must distinguish between findings visualized on stored images versus findings noted during real-time scanning, and should explicitly document when a region was not adequately visualized due to body habitus, bowel gas, or patient cooperation. --- ## Checkpoint A: Pre-Draft Intake (Mandatory) 1. **What type of ultrasound study is being interpreted?** (Default: Abdominal — specify: thyroid, pelvic, obstetric, vascular, renal, testicular, breast, MSK) 2. **What is the clinical indication?** (Default: Replace with actual indication from requisition) 3. **Are prior ultrasound studies available?** (Default: No priors) 4. **Were Doppler images obtained?** (Default: Yes, color and spectral Doppler included) 5. **Is this a screening or diagnostic study?** (Default: Diagnostic) 6. **Are there known lesions requiring follow-up measurement?** (Default: No) 7. **Was the study limited by patient factors (body habitus, bowel gas, non-fasting)?** (Default: No limitations) ### Documents to Request - All static ultrasound images with annotations - Cine clips (when available in PACS) - Doppler waveform images with velocity measurements - Sonographer worksheets with measurements - Prior ultrasound reports and images for comparison - Relevant lab values (hCG for OB, AFP/liver function for hepatic, TSH for thyroid) - Requisition with clinical indication --- ## Step 1: Technical Assessment and Study Completeness Verify that required views per ACR practice parameters are included. ### Abdominal Ultrasound — Required Views - Liver: right lobe (sagittal and transverse), left lobe, dome - Gallbladder: long axis and transverse; wall thickness; CBD measurement - Pancreas: head, body, tail (or note if obscured by gas) - Kidneys: bilateral long axis with measurement; cortical thickness - Spleen: long axis with measurement - Aorta: proximal, mid, distal with AP diameter ### Thyroid Ultrasound — Required Views - Each lobe: transverse and longitudinal with three-dimension measurements - Isthmus: AP measurement - Nodules: three dimensions, echogenicity, composition, margins, calcifications - Regional lymph nodes: levels III, IV, VI ### Pelvic Ultrasound — Required Views - Uterus: sagittal and transverse with dimensions; endometrial thickness - Ovaries: bilateral with dimensions and volume calculation - Adnexae: cul-de-sac for free fluid - Transvaginal images when transabdominal is limited Document any views not obtained and the reason (e.g., "Pancreatic tail not visualized due to overlying bowel gas"). --- ## Step 2: Organ-Specific Interpretation ### Thyroid — ACR TI-RADS Classification (2017) Score each nodule using the five TI-RADS categories: | Feature | 0 Points | 1 Point | 2 Points | 3 Points | |---------|----------|---------|----------|----------| | **Composition** | Cystic/spongiform | Mixed cystic-solid | Solid or almost solid | — | | **Echogenicity** | Anechoic | Hyper/isoechoic | Hypoechoic | Very hypoechoic | | **Shape** | Wider than tall | — | Taller than wide | — | | **Margin** | Smooth | — | Irregular | Extra-thyroidal extension | | **Echogenic foci** | None/large comet-tail | — | Macrocalcifications | Punctate echogenic foci | | TI-RADS Level | Points | FNA Threshold | Follow-up Threshold | |---------------|--------|---------------|---------------------| | TR1 — Benign | 0 | No FNA | No follow-up | | TR2 — Not Suspicious | 2 | No FNA | No follow-up | | TR3 — Mildly Suspicious | 3 | ≥2.5 cm | ≥1.5 cm | | TR4 — Moderately Suspicious | 4–6 | ≥1.5 cm | ≥1.0 cm | | TR5 — Highly Suspicious | ≥7 | ≥1.0 cm | ≥0.5 cm | ### Hepatobiliary - Liver echogenicity: normal, increased (fatty infiltration), coarsened (cirrhosis) - Gallbladder wall: <3 mm normal; document stones, polyps, sludge - CBD: <7 mm (or <10 mm post-cholecystectomy); measure at porta hepatis - Portal vein: diameter, flow direction, velocity ### Renal - Kidney length: 9–12 cm adult normal - Cortical thickness: >1 cm normal - Hydronephrosis grading: mild, moderate, severe (SFU system for pediatric) - Renal masses: Bosniak classification applicable; document vascularity on Doppler --- ## Step 3: Doppler Evaluation | Study Type | Key Measurements | Normal Values | |-----------|-----------------|---------------| | Carotid duplex | ICA PSV, EDV, ICA/CCA ratio | <125 cm/s PSV = <50% stenosis | | Renal artery | PSV, RI, acceleration time | RI 0.55–0.70; AT <70 ms | | Hepatic | Portal vein velocity and direction | 15–40 cm/s, hepatopetal | | DVT lower extremity | Compressibility, augmentation, spectral waveform | Full compressibility, phasic flow | | Testicular | Intratesticular flow symmetry | Symmetric arterial flow bilaterally | Always report spectral waveform pattern (low vs. high resistance), velocity values, and any reversal of flow. --- ## Step 4: Report Structure ### Header - Patient demographics, study date, accession - Examination type (e.g., "Complete abdominal ultrasound with Doppler") - Clinical indication ### Comparison - Prior ultrasound studies with dates; note modality differences (e.g., prior CT comparison) ### Technique - Transducer type and frequency (if available) - Scanning approach (transabdominal, transvaginal, both) - Fasting status for hepatobiliary studies - Technical limitations ### Findings - Organ-by-organ in standard order - Each finding: location → sonographic characteristics → dimensions → Doppler findings → change from prior ### Impression - Numbered, clinically significant findings first - Classification assignments (TI-RADS, Bosniak, etc.) - Specific follow-up recommendations with timing and modality --- ## Step 5: Follow-Up Recommendations Always specify follow-up per relevant classification system or ACR Incidental Findings Committee. | Finding | Recommendation | |---------|---------------| | TI-RADS 3 nodule ≥1.5 cm | Follow-up US in 1, 3, 5 years | | TI-RADS 4 nodule ≥1.5 cm | FNA recommended | | Simple hepatic cyst | No follow-up | | Complex ovarian cyst, premenopausal | Repeat US in 6–12 weeks | | Gallbladder polyp >10 mm | Cholecystectomy referral | | Gallbladder polyp 6–9 mm | US in 6 months, then annually | | Abdominal aortic aneurysm 3.0–3.9 cm | Repeat US in 12 months | | AAA 4.0–5.4 cm | Repeat US in 6 months | --- ## Checkpoint B: Post-Draft Alignment (Mandatory) 1. Are all required views documented or limitations noted? 2. Are classification systems (TI-RADS, Bosniak) correctly applied with all scoring features? 3. Do Doppler measurements include actual velocity values? 4. Are follow-up recommendations specific with timing and modality? 5. Is the impression addressing the clinical question directly? --- ## Quality Audit - [ ] Study completeness is assessed (all required views per ACR) - [ ] Technical limitations are explicitly documented - [ ] Each visualized organ includes dimensions where applicable - [ ] TI-RADS scoring shows individual feature scores and total points - [ ] Doppler evaluations include numeric velocity values (not just "normal") - [ ] Gallbladder wall thickness and CBD diameter are measured - [ ] Renal length and cortical thickness are documented bilaterally - [ ] Liver echogenicity is characterized relative to renal cortex - [ ] Classification systems are applied with management recommendations - [ ] Prior comparisons referenced with specific dates - [ ] Impression items are numbered and clinically prioritized - [ ] Non-visualized structures are documented with reason - [ ] Fasting status noted for hepatobiliary exams - [ ] Laterality is explicit for all paired organs --- ## Guidelines 1. Always document study completeness — ultrasound is operator-dependent and incomplete studies require explicit notation. 2. Apply ACR TI-RADS with itemized feature scores; do not assign a TI-RADS level without documenting each criterion. 3. Report Doppler values numerically — qualitative descriptors like "normal flow" are insufficient. 4. Measure the CBD at the porta hepatis consistently; document whether the patient was fasting. 5. For obstetric ultrasound, follow AIUM Practice Parameters for gestational age assessment, anatomy survey completeness, and biometric measurements. 6. When body habitus limits evaluation, recommend alternative imaging (CT or MRI) rather than simply noting the limitation. 7. Classify ovarian lesions using the O-RADS system when applicable, including risk stratification and management recommendation.
Related Skills
reporting-nuclear-medicine-studies
Structures nuclear medicine and PET/CT interpretation with SUV measurement and staging correlation. Use when reading nuclear medicine studies, interpreting PET findings, or documenting radiotracer uptake.
reporting-mri-studies
Structures MRI interpretation with sequence-specific analysis and standardized reporting. Use when reading MRI studies, creating MRI reports, or analyzing multisequence findings.
reporting-ct-scans
Structures CT scan interpretation by body region with standardized measurement and comparison techniques. Use when interpreting CT studies, creating CT reports, or documenting cross-sectional findings.
reporting-chest-radiographs
Structures systematic chest X-ray interpretation with standardized reporting and critical findings communication. Use when reading chest X-rays, creating radiology reports, or documenting CXR findings.
protocolling-imaging-studies
Selects appropriate imaging protocols based on clinical indication and patient factors. Use when choosing imaging protocols, selecting contrast parameters, or determining appropriate study type.
managing-quality-reporting
Structures CMS quality reporting (MIPS, HEDIS, CQMs) with measure specification and data validation. Use when reporting quality measures, managing MIPS submissions, or validating quality data.
managing-adverse-event-reporting-research
Documents research adverse events with causality assessment and regulatory reporting timelines. Use when reporting research AEs, assessing causality, or managing safety reporting.
interpreting-coagulation-studies
Structures coagulation test interpretation with mixing studies and inhibitor identification. Use when interpreting coag panels, evaluating bleeding disorders, or analyzing mixing study results.
documenting-ultrasound-obstetric
Structures obstetric ultrasound reporting with biometry, anatomy survey, and growth assessment. Use when reporting OB ultrasounds, documenting fetal anatomy, or tracking fetal growth.
designing-observational-studies
Structures observational study designs (cohort, case-control, cross-sectional) with bias mitigation strategies. Use when designing observational research, mitigating bias, or planning epidemiologic studies.
adverse-event-reporting-policy
Drafts an Adverse Event Reporting Policy compliant with 21 CFR 312.32 (IND safety reporting), 21 CFR 314.80 (postmarketing), and ICH E2A, with multi-jurisdictional overlays (EMA, PMDA, Health Canada). Covers seriousness/causality frameworks, expedited reporting timelines, roles, documentation standards, training mandates, and QA mechanisms. Use when drafting or updating an adverse event reporting policy, pharmacovigilance policy, AE/SAE reporting SOP, or safety reporting framework for a pharmaceutical company, CRO, biotech, or clinical research institution.
managing-tax-information-reporting
Structures Form 1099, W-2, and other information reporting with classification and filing requirements. Use when managing tax reporting, classifying payments, or ensuring filing compliance.