Medical Report Simplifier

Step 2: Extract Key Information

Pull out these elements from the report (not all will be present):

1. Patient details — Age, gender (anonymize if needed, don't repeat full name)
2. Test/procedure performed — What was done?
3. Findings — What did they observe?
4. Abnormal values — What is outside the normal range? (flag clearly)
5. Diagnosis or impression — What conclusion did the doctor reach?
6. Recommendations — What should happen next?
7. Medications mentioned — Names, dosages, purpose
8. Medical terms to explain — Jargon that needs plain-English translation

Step 3: Generate the Simplified Report

Structure the output in this exact format:

🏥 What Kind of Report Is This?

[One sentence: type of report, which body part or system it covers]

📋 What Was Tested / Done?

[Plain English explanation of the procedure or tests performed]

🔍 What Did They Find?

[Summary of findings in simple language. Use bullet points for multiple findings. For lab results, show: Test Name | Your Value | Normal Range | What It Means]

⚠️ Things That Need Attention

[Only include if there are abnormal values or concerning findings. Be factual but calm — do not alarm unnecessarily. Use plain language: "Your iron levels are lower than normal, which can cause tiredness" instead of "microcytic hypochromic anemia noted".]

✅ Things That Look Normal

[Briefly list what is within normal range — reassures the patient]

💊 Medications / Treatments Mentioned

[If any: Drug name (common name) — what it's for — typical dosage]

📖 Medical Words Explained

[Glossary of any complex terms used in the report, in simple English. Format: Term — plain English meaning]

❓ Questions to Ask Your Doctor

[3–5 suggested questions the patient should ask at their next appointment, based on the specific findings in this report]

⚠️ Disclaimer

This simplification is for educational purposes only and does not constitute medical advice. Please consult your doctor or healthcare provider for any medical decisions.

Step 4: Tone & Language Rules

Always follow these when writing the simplified output:

• Use simple words: "high" not "elevated", "low" not "deficient", "heart" not "cardiac"
• Be calm and reassuring: avoid dramatic language even for serious findings
• Be accurate: do not downplay genuinely abnormal results — flag them clearly but gently
• No jargon without explanation: every medical term must be explained in plain English
• Short sentences: aim for 8th grade reading level (Flesch-Kincaid ~60–70)
• Empathetic tone: remember this person may be anxious about their health
• Do not diagnose: explain what the report says, not what it "means" for their future
• Do not recommend treatment: only reflect what the report/doctor already said

Step 5: Handle Special Cases

If the report has CRITICAL / URGENT values:

Flag these prominently at the top:

🚨 Important: This report contains values marked as critical. Please contact your doctor or seek medical attention promptly.

If the report is cancer-related (pathology/oncology):

• Be especially gentle and factual
• Explain staging simply: "Stage 2 means the cancer is present but has not spread to distant organs"
• Always emphasize that the doctor will discuss treatment options
• Read references/oncology-terms.md for common cancer terminology

If it's a pediatric report (child's report):

• Address the parent/guardian
• Use age-appropriate context for values (normal ranges differ for children)

If values are missing normal ranges:

• Use standard adult reference ranges from references/lab-normal-ranges.md
• Note: "Normal range based on standard adult reference values"

If the document is not in English:

• Translate first, then simplify
• Note the original language at the top

Output Format

• Default output: well-formatted markdown in the conversation
• If user asks for a file: generate a clean .docx using the docx skill
• If user asks for a PDF: generate using the pdf skill
• Keep the output concise but complete — do not pad, do not omit critical findings

Reference Files

Load these only when needed: