Patient Communication Simplifier
Overview
This skill transforms complex medical communications (clinical notes, consent forms, discharge instructions, benefit explanations, care plans) into plain-language content accessible to patients at varying health literacy levels. It applies validated readability assessment instruments (Flesch-Kincaid, SMOG, Fry Readability Graph) and suitability evaluation tools (Suitability Assessment of Materials, SAM) to ensure output meets national health literacy standards. The CDC recommends patient materials target a 6th-8th grade reading level; nearly 36% of U.S. adults have basic or below-basic health literacy (NAAL).
When to Use
- Converting clinical documentation into patient-facing after-visit summaries
- Simplifying consent forms, advance directives, or financial agreements
- Rewriting patient education materials for lower literacy audiences
- Preparing content for patient portals that must meet Meaningful Use plain-language requirements
- Adapting communications for specific populations (elderly, pediatric caregivers, LEP post-translation)
- Responding to CMS or Joint Commission findings on patient communication adequacy
Required Inputs
| Input |
Description |
Format |
source_content |
Original clinical or administrative text to simplify |
String |
content_type |
Category: discharge_instructions, consent_form, care_plan, education_material, correspondence |
String |
target_reading_level |
Desired grade level (default: 6th grade) |
Number |
patient_context |
Target audience characteristics (age range, condition, cultural considerations) |
JSON object |
clinical_accuracy_reviewer |
Identifier for clinical SME who will validate accuracy |
String |
output_format |
Desired format: plain_text, html, structured_json |
String |
Methodology
Step 1: Source Content Analysis
- Compute baseline readability metrics on the source document:
- Flesch-Kincaid Grade Level: 0.39 x (total words/total sentences) + 11.8 x (total syllables/total words) - 15.59
- SMOG Index: 3 + sqrt(polysyllable count x 30/total sentences)
- Flesch Reading Ease: 206.835 - 1.015 x (words/sentences) - 84.6 x (syllables/words), target 60 or above
- Identify clinical jargon, abbreviations, acronyms, and complex sentence structures
- Flag sentences exceeding 20 words (recommended maximum for patient materials)
- Catalogue multi-syllabic medical terms requiring simplification or definition
Step 2: Terminology Simplification
- Replace medical jargon with plain-language equivalents using validated substitution lists:
- "hypertension" becomes "high blood pressure"
- "myocardial infarction" becomes "heart attack"
- "bilateral" becomes "on both sides"
- "contraindicated" becomes "should not be used"
- "prophylaxis" becomes "prevention"
- "etiology" becomes "cause"
- "benign" becomes "not cancer" or "not harmful"
- "prognosis" becomes "what we expect to happen"
- When a medical term must be retained (medication names, diagnosis for insurance), introduce it with its plain-language equivalent: "metformin (your diabetes medicine)"
- Preserve clinical precision: simplification must not introduce ambiguity or inaccuracy
Step 3: Structural Simplification
- Apply plain-language writing principles (per PlainLanguage.gov and NIH Clear Communication):
- Use active voice ("Take your medicine at 8 AM" not "Medicine should be taken at 8 AM")
- Use second person ("you/your") to address the patient directly
- Limit sentences to 15-20 words maximum
- One idea per sentence, one topic per paragraph
- Use headers and bullet points to organize information
- Lead with the most important information (inverted pyramid)
- Use concrete numbers instead of vague terms ("every 4 hours" not "frequently")
- Apply chunking: group related instructions under clear action-oriented headers
- "What to Do at Home"
- "When to Call Your Doctor"
- "Your Medicines"
- "Your Next Appointment"
Step 4: Visual and Layout Optimization
- Recommend design elements that improve comprehension:
- White space: 1-inch margins minimum, 1.15 line spacing minimum
- Font: Sans-serif, 12pt minimum (14pt for elderly audiences)
- Contrast: Dark text on light background (WCAG AA minimum)
- Visuals: Simple illustrations or icons to reinforce key concepts
- Highlight critical safety information (warning signs, emergency instructions)
- Structure content for SAM evaluation targeting "superior" rating (70-100%)
Step 5: Readability Verification
- Recompute readability scores on simplified output:
- Flesch-Kincaid Grade Level at or below target (default: 6.0)
- SMOG Index at or below target + 1 grade level
- Flesch Reading Ease of 60 or above (70 or above preferred)
- Apply SAM assessment across six domains:
- Content (purpose, scope, summary)
- Literacy demand (reading level, vocabulary, context, sentence construction)
- Graphics (cover, type, relevance, captions)
- Layout and Typography (subheadings, cues, whitespace)
- Learning stimulation (interaction, modeling, motivation)
- Cultural appropriateness (match to audience experience and imagery)
- Score: Not Suitable (0-39%), Adequate (40-69%), Superior (70-100%)
Step 6: Teach-Back Verification Framework
- Generate 3-5 teach-back questions for each content section:
- "In your own words, what should you do if [symptom] happens?"
- "Can you show me how you would take your medicine based on these instructions?"
- "What is the most important thing to watch for after you go home?"
- Design questions to verify comprehension of critical safety information
- Include suggested scripts for staff administering teach-back
Output Specification
simplified_content:
original_metrics:
flesch_kincaid_grade: number
smog_index: number
flesch_reading_ease: number
word_count: number
avg_sentence_length: number
simplified_metrics:
flesch_kincaid_grade: number
smog_index: number
flesch_reading_ease: number
word_count: number
avg_sentence_length: number
sam_score_percent: number
sam_rating: string
content:
sections:
- heading: string
body: string
critical_safety: boolean
terminology_changes:
- original_term: string
simplified_term: string
context: string
teach_back_questions:
- section: string
question: string
expected_response_elements: array
design_recommendations:
font: string
font_size: string
layout_notes: array
clinical_review_status: string
Analysis Framework
Apply the CDC Clear Communication Index (CCI) as the primary evaluation framework:
- Main message: Is the main message obvious and stated early?
- Language: Are words common and sentences short?
- Information design: Is the layout clean with clear visual hierarchy?
- State of the science: Is the information accurate and evidence-based?
- Behavioral recommendations: Are actions specific and achievable?
- Numbers: Are numbers simple, necessary, and explained?
- Risk: Are risks and benefits presented clearly and without bias?
Target CCI score: 90 out of 100 or higher.
Examples
Example: Discharge Instructions for Heart Failure
- Original (Grade 12.4): "Patient is advised to adhere to a sodium-restricted diet of less than 2000mg daily, monitor daily weight fluctuations, and report any acute dyspnea, peripheral edema, or weight gain exceeding 3 pounds in 24 hours to the prescribing cardiologist."
- Simplified (Grade 5.8): "Eat less salt. Try to have less than 2,000 mg of salt each day. Weigh yourself every morning before eating. Call your heart doctor right away if: you gain more than 3 pounds in one day, your feet or legs swell up, or you have trouble breathing."
- FK Grade reduction: 12.4 to 5.8; Flesch Reading Ease: 34 to 72; SAM: Superior (82%)
Guidelines
- HIPAA Compliance: Simplified content must not introduce PHI not present in the source. If source contains PHI, maintain same access controls on output. De-identify any examples used for training or quality improvement.
- Clinical Accuracy: Every simplification must be reviewed by a clinical SME before patient distribution. Simplification must never sacrifice accuracy for readability.
- Cultural Sensitivity: Avoid idioms, metaphors, and culturally specific references that may not translate across populations. Use person-first language ("person with diabetes" not "diabetic").
- Regulatory Compliance: Meet Promoting Interoperability requirements for patient-accessible clinical information. Comply with ACA Section 1557 requirements for accessible communications.
- Accessibility: Ensure output is screen-reader compatible. Provide alt-text recommendations for any visual elements. Follow WCAG 2.1 AA standards.
Validation Checklist
1---2name: patient-communication-simplifier3description: Transform complex clinical and administrative healthcare communications into plain-language content calibrated to target health literacy levels using Flesch-Kincaid, SMOG, and SAM scoring with teach-back verification frameworks.45metadata:6 display_name: "Patient Communication Simplifier"7 short_description: "Simplify clinical communications for patient readability"8 default_prompt: "Generate patient communication for my case with clear next steps"9 version: "1.0.0"10 tags:11 - healthcare12 icon_path: "assets/icon.png"13---1415# Patient Communication Simplifier1617## Overview1819This skill transforms complex medical communications (clinical notes, consent forms, discharge instructions, benefit explanations, care plans) into plain-language content accessible to patients at varying health literacy levels. It applies validated readability assessment instruments (Flesch-Kincaid, SMOG, Fry Readability Graph) and suitability evaluation tools (Suitability Assessment of Materials, SAM) to ensure output meets national health literacy standards. The CDC recommends patient materials target a 6th-8th grade reading level; nearly 36% of U.S. adults have basic or below-basic health literacy (NAAL).2021## When to Use2223- Converting clinical documentation into patient-facing after-visit summaries24- Simplifying consent forms, advance directives, or financial agreements25- Rewriting patient education materials for lower literacy audiences26- Preparing content for patient portals that must meet Meaningful Use plain-language requirements27- Adapting communications for specific populations (elderly, pediatric caregivers, LEP post-translation)28- Responding to CMS or Joint Commission findings on patient communication adequacy2930## Required Inputs3132| Input | Description | Format |33|-------|-------------|--------|34| `source_content` | Original clinical or administrative text to simplify | String |35| `content_type` | Category: discharge_instructions, consent_form, care_plan, education_material, correspondence | String |36| `target_reading_level` | Desired grade level (default: 6th grade) | Number |37| `patient_context` | Target audience characteristics (age range, condition, cultural considerations) | JSON object |38| `clinical_accuracy_reviewer` | Identifier for clinical SME who will validate accuracy | String |39| `output_format` | Desired format: plain_text, html, structured_json | String |4041## Methodology4243### Step 1: Source Content Analysis44- Compute baseline readability metrics on the source document:45 - **Flesch-Kincaid Grade Level**: 0.39 x (total words/total sentences) + 11.8 x (total syllables/total words) - 15.5946 - **SMOG Index**: 3 + sqrt(polysyllable count x 30/total sentences)47 - **Flesch Reading Ease**: 206.835 - 1.015 x (words/sentences) - 84.6 x (syllables/words), target 60 or above48- Identify clinical jargon, abbreviations, acronyms, and complex sentence structures49- Flag sentences exceeding 20 words (recommended maximum for patient materials)50- Catalogue multi-syllabic medical terms requiring simplification or definition5152### Step 2: Terminology Simplification53- Replace medical jargon with plain-language equivalents using validated substitution lists:54 - "hypertension" becomes "high blood pressure"55 - "myocardial infarction" becomes "heart attack"56 - "bilateral" becomes "on both sides"57 - "contraindicated" becomes "should not be used"58 - "prophylaxis" becomes "prevention"59 - "etiology" becomes "cause"60 - "benign" becomes "not cancer" or "not harmful"61 - "prognosis" becomes "what we expect to happen"62- When a medical term must be retained (medication names, diagnosis for insurance), introduce it with its plain-language equivalent: "metformin (your diabetes medicine)"63- Preserve clinical precision: simplification must not introduce ambiguity or inaccuracy6465### Step 3: Structural Simplification66- Apply plain-language writing principles (per PlainLanguage.gov and NIH Clear Communication):67 - Use active voice ("Take your medicine at 8 AM" not "Medicine should be taken at 8 AM")68 - Use second person ("you/your") to address the patient directly69 - Limit sentences to 15-20 words maximum70 - One idea per sentence, one topic per paragraph71 - Use headers and bullet points to organize information72 - Lead with the most important information (inverted pyramid)73 - Use concrete numbers instead of vague terms ("every 4 hours" not "frequently")74- Apply chunking: group related instructions under clear action-oriented headers75 - "What to Do at Home"76 - "When to Call Your Doctor"77 - "Your Medicines"78 - "Your Next Appointment"7980### Step 4: Visual and Layout Optimization81- Recommend design elements that improve comprehension:82 - White space: 1-inch margins minimum, 1.15 line spacing minimum83 - Font: Sans-serif, 12pt minimum (14pt for elderly audiences)84 - Contrast: Dark text on light background (WCAG AA minimum)85 - Visuals: Simple illustrations or icons to reinforce key concepts86 - Highlight critical safety information (warning signs, emergency instructions)87- Structure content for SAM evaluation targeting "superior" rating (70-100%)8889### Step 5: Readability Verification90- Recompute readability scores on simplified output:91 - Flesch-Kincaid Grade Level at or below target (default: 6.0)92 - SMOG Index at or below target + 1 grade level93 - Flesch Reading Ease of 60 or above (70 or above preferred)94- Apply SAM assessment across six domains:95 - Content (purpose, scope, summary)96 - Literacy demand (reading level, vocabulary, context, sentence construction)97 - Graphics (cover, type, relevance, captions)98 - Layout and Typography (subheadings, cues, whitespace)99 - Learning stimulation (interaction, modeling, motivation)100 - Cultural appropriateness (match to audience experience and imagery)101- Score: Not Suitable (0-39%), Adequate (40-69%), Superior (70-100%)102103### Step 6: Teach-Back Verification Framework104- Generate 3-5 teach-back questions for each content section:105 - "In your own words, what should you do if [symptom] happens?"106 - "Can you show me how you would take your medicine based on these instructions?"107 - "What is the most important thing to watch for after you go home?"108- Design questions to verify comprehension of critical safety information109- Include suggested scripts for staff administering teach-back110111## Output Specification112113```yaml114simplified_content:115 original_metrics:116 flesch_kincaid_grade: number117 smog_index: number118 flesch_reading_ease: number119 word_count: number120 avg_sentence_length: number121 simplified_metrics:122 flesch_kincaid_grade: number123 smog_index: number124 flesch_reading_ease: number125 word_count: number126 avg_sentence_length: number127 sam_score_percent: number128 sam_rating: string129 content:130 sections:131 - heading: string132 body: string133 critical_safety: boolean134 terminology_changes:135 - original_term: string136 simplified_term: string137 context: string138 teach_back_questions:139 - section: string140 question: string141 expected_response_elements: array142 design_recommendations:143 font: string144 font_size: string145 layout_notes: array146 clinical_review_status: string147```148149## Analysis Framework150151Apply the **CDC Clear Communication Index** (CCI) as the primary evaluation framework:1521. **Main message**: Is the main message obvious and stated early?1532. **Language**: Are words common and sentences short?1543. **Information design**: Is the layout clean with clear visual hierarchy?1554. **State of the science**: Is the information accurate and evidence-based?1565. **Behavioral recommendations**: Are actions specific and achievable?1576. **Numbers**: Are numbers simple, necessary, and explained?1587. **Risk**: Are risks and benefits presented clearly and without bias?159160Target CCI score: 90 out of 100 or higher.161162## Examples163164**Example: Discharge Instructions for Heart Failure**165- Original (Grade 12.4): "Patient is advised to adhere to a sodium-restricted diet of less than 2000mg daily, monitor daily weight fluctuations, and report any acute dyspnea, peripheral edema, or weight gain exceeding 3 pounds in 24 hours to the prescribing cardiologist."166- Simplified (Grade 5.8): "Eat less salt. Try to have less than 2,000 mg of salt each day. Weigh yourself every morning before eating. Call your heart doctor right away if: you gain more than 3 pounds in one day, your feet or legs swell up, or you have trouble breathing."167- FK Grade reduction: 12.4 to 5.8; Flesch Reading Ease: 34 to 72; SAM: Superior (82%)168169## Guidelines170171- **HIPAA Compliance**: Simplified content must not introduce PHI not present in the source. If source contains PHI, maintain same access controls on output. De-identify any examples used for training or quality improvement.172- **Clinical Accuracy**: Every simplification must be reviewed by a clinical SME before patient distribution. Simplification must never sacrifice accuracy for readability.173- **Cultural Sensitivity**: Avoid idioms, metaphors, and culturally specific references that may not translate across populations. Use person-first language ("person with diabetes" not "diabetic").174- **Regulatory Compliance**: Meet Promoting Interoperability requirements for patient-accessible clinical information. Comply with ACA Section 1557 requirements for accessible communications.175- **Accessibility**: Ensure output is screen-reader compatible. Provide alt-text recommendations for any visual elements. Follow WCAG 2.1 AA standards.176177## Validation Checklist178179- [ ] Baseline readability scores computed on source content180- [ ] Target reading level achieved (Flesch-Kincaid at or below target grade)181- [ ] SMOG Index within 1 grade level of target182- [ ] Flesch Reading Ease of 60 or above183- [ ] SAM assessment completed with score of 70% or above (Superior)184- [ ] All medical jargon replaced or defined in context185- [ ] Sentence length 20 words or fewer on average186- [ ] Active voice used throughout187- [ ] Teach-back questions generated for each content section188- [ ] Clinical accuracy review assigned and tracked189- [ ] Cultural sensitivity review completed190- [ ] HIPAA compliance verified: no unintended PHI exposure191- [ ] Design recommendations included for print and digital formatting