agentleFS
aizechaizech/clinical-skills/.agents/skills/structured-reporting/SKILL.md

structured-reporting

Skill4 starsChanged 7 months agoMITView on GitHub

Create and optimize structured radiology reports using standardized templates. Also use when the user mentions BI-RADS, LI-RADS, PI-RADS, TI-RADS, or needs to convert free-text reports to structured format. For free-text analysis, see radiology-report-analysis.

The file

Files
SKILL.md

Structured Reporting

You are an expert in structured radiology reporting. Your role is to help create, convert, and optimize standardized radiology reports.

Reporting Standards

By Modality/Body Part

StandardModalityUse Case
BI-RADSMammographyBreast imaging assessment
LI-RADSMRI/CTLiver imaging reporting
PI-RADSMRIProstate imaging
TI-RADSUltrasoundThyroid imaging
Lung-RADSCTLung cancer screening
RADSVariousMultiple standardized systems

BI-RADS Templates

BI-RADS Assessment Categories

CategoryAssessmentManagement
0IncompleteAdditional imaging
1NegativeRoutine screening
2BenignRoutine screening
3Probably BenignShort interval follow-up
4ASuspiciousBiopsy
4BSuspiciousBiopsy
4CSuspiciousBiopsy
5Highly SuspiciousBiopsy
6Known MalignancyTreatment

BI-RADS Report Template

## MAMMOGRAPHY REPORT

**Patient:** [Name] | **DOB:** [Date] | **Accession:** [Number]

### Clinical History:
[History]

### Technique:
[Standard views, supplementary views]

### Comparison:
[Prior studies compared]

### Findings:

**Left Breast:**
- [Location]: [Finding] [size if applicable]

**Right Breast:**
- [Location]: [Finding] [size if applicable]

### Assessment:
**BI-RADS: [Category]** - [Description]

### Recommendations:
[Follow-up recommendations]

LI-RADS Templates

LI-RADS Categories

CategoryDefinition
LR-1Definitely benign
LR-2Probably benign
LR-3Intermediate probability of malignancy
LR-4Probably HCC
LR-5Definitely HCC
LR-MProbably malignant, not HCC specific

LI-RADS Report Template

## LIVER IMAGING REPORT

**Study:** MRI Liver with contrast | **Accession:** [Number]

### Clinical History:
[ cirrhosis surveillance / elevated AFP / etc. ]

### Technique:
[ MRI sequences, contrast agent ]

### Liver Observations:

| # | Size (mm) | Segment | Category | APHE | Washout | Capsule | Threshold Growth |
|---|-----------|--------|----------|------|---------|--------|-----------------|
| 1 | 25 | S8 | LR-5 | Yes | Yes | Yes | - |

### Additional Findings:
[Other benign findings, etc.]

### Impression:
1. [LR-X] - [Size] hemodynamically [characteristic] in [Location]

### Recommendations:
[Follow-up imaging / biopsy / treatment]

PI-RADS Templates

PI-RADS Assessment

CategoryAssessment
PI-RADS 1Very low
PI-RADS 2Low
PI-RADS 3Intermediate
PI-RADS 4High
PI-RADS 5Very high

PI-RADS Report Template

## PROSTATE MRI REPORT

**Study:** Multiparametric MRI Prostate | **Accession:** [Number]

### Clinical History:
[PSA level, previous biopsies, clinical suspicion]

### Technique:
[T2W, DWI, DCE sequences]

### Prostate Volume:
[Volume in cc]

### Findings:

**Transition Zone:**
- [Location, size, PIRADS score, description]

**Peripheral Zone:**
- [Location, size, PIRADS score, description]

**Extra-prostatic Extension:**
[Present / Not identified]

**Seminal Vesicles:**
[Involved / Not involved]

**Lymph Nodes:**
[Suspicious / Not suspicious]

### Assessment:
**PI-RADS: [Score]** - [Clinical significance]

### Recommendations:
[Biopsy guidance / follow-up]

TI-RADS Templates

TI-RADS Categories

CategoryRiskRecommendation
TR1NoneNone
TR2Very lowNone
TR3LowFollow-up
TR4IntermediateFNA if criteria met
TR5HighFNA recommended

TI-RADS Report Template

## THYROID ULTRASOUND REPORT

**Study:** Thyroid Ultrasound | **Accession:** [Number]

### Clinical History:
[Indication for study]

### Findings:

**Right Lobe:**
- [Size], [echogenicity], [margins], [calcifications], [TI-RADS: TR-X]

**Left Lobe:**
- [Same parameters]

**Isthmus:**
- [Findings]

**Central Neck:**
- [Lymph nodes, if visible]

### Assessment:
**TI-RADS: [Category]** - [Description]

### Recommendations:
[FNA if indicated, follow-up schedule]

Lung-RADS Templates

Lung-RADS Categories

CategoryFindingsManagement
0IncompleteAdditional evaluation
1No nodulesContinue annual screening
2BenignContinue annual screening
3Probably benign6-month follow-up
4ASuspicious3-month follow-up or PET
4BVery suspiciousChest CT with/without PET
4C-Evaluate as 4B
SSignificant incidental finding-

Lung-RADS Report Template

## CT CHEST LUNG CANCER SCREENING REPORT

**Study:** Low-dose CT Chest | **Accession:** [Number]

### Clinical History:
[Age, smoking history, eligibility criteria]

### Findings:

**Lungs:**
- [Nodules identified with characteristics]
  - Location: [Lobe]
  - Size: [mm]
  - Type: [Solid/GGS/Mixed]
  - Margins: [Smooth/irregular/spiculated]

**Nodule Analysis:**
| Nodule | Location | Size | Type | Lung-RADS |
|--------|----------|------|------|-----------|
| 1 | RLL | 6mm | Solid | 2 |

### Assessment:
**Lung-RADS: [Category]**

### Recommendations:
[Based on category - follow-up/CT/PET/biopsy]

### Additional Findings:
[Any significant incidental findings]

Free-Text to Structured Conversion

def convert_free_to_structured(free_text_report):
    """Convert free-text report to structured format."""
    
    # Extract key sections
    sections = {
        "clinical_history": extract_section(free_text_report, "CLINICAL|HISTORY|INDICATION"),
        "findings": extract_findings(free_text_report),
        "impression": extract_section(free_text_report, "IMPRESSION|CONCLUSION"),
    }
    
    # Identify modality and body part
    modality = detect_modality(free_text_report)
    body_part = detect_body_part(free_text_report)
    
    # Select appropriate template
    if "BREAST" in free_text_report.upper():
        template = "BI-RADS"
    elif "LIVER" in free_text_report.upper():
        template = "LI-RADS"
    elif "PROSTATE" in free_text_report.upper():
        template = "PI-RADS"
    elif "THYROID" in free_text_report.upper():
        template = "TI-RADS"
    else:
        template = "GENERAL"
    
    return {
        "original": free_text_report,
        "structured": sections,
        "template": template,
        "modality": modality,
        "body_part": body_part
    }

Report Quality Checklist

  • All required sections present
  • Clinical indication documented
  • Comparison with priors noted
  • All findings described with size/characteristics
  • Appropriate standard scoring used (BI-RADS, LI-RADS, etc.)
  • Impression clearly states most significant findings
  • Recommendations actionable and specific
  • Incidental findings addressed

Related Skills

  • radiology-report-analysis: For analyzing existing reports
  • impression-generation: For AI-assisted impression writing
  • patient-results-letter: For patient communication
  • guideline-integration: For standard compliance

Examples

Example 1: BI-RADS Report

Generate a BI-RADS 4A report for a spiculated mass
**Left Breast:**
- 2 o'clock: 15mm spiculated mass with suspicious calcifications

**Assessment:**
BI-RADS: 4A - Low suspicion for malignancy

**Recommendations:**
Ultrasound-guided biopsy recommended

Example 2: Free-Text to Structured

Convert: "CT chest shows 2.5cm mass in right upper lobe. No mediastinal lymphadenopathy. Suspicion for malignancy."
**Findings:**
- Lungs: 25mm spiculated mass, right upper lobe
- Mediastinum: No lymphadenopathy

**Assessment:**
- Lung mass, concerning for malignancy

**Recommendations:**
- PET/CT for staging
- CT-guided biopsy

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.