AlterLab-Academic-Skills alterlab-clinical-reports
Writes comprehensive clinical reports — case reports (CARE guidelines), diagnostic reports (radiology, pathology, lab), clinical trial reports (ICH-E3, SAE, CSR), and patient documentation (SOAP notes, H&P, discharge summaries) — with templates, regulatory compliance (HIPAA, FDA, ICH-GCP), and validation tools. Use when drafting a case report for journal publication, a radiology/pathology/lab diagnostic report, an ICH-E3 clinical study report (CSR) or SAE narrative, or SOAP/H&P/discharge patient records needing regulatory-compliant formatting. Part of the AlterLab Academic Skills suite.
git clone https://github.com/AlterLab-IEU/AlterLab-Academic-Skills
T=$(mktemp -d) && git clone --depth=1 https://github.com/AlterLab-IEU/AlterLab-Academic-Skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/clinical-research/alterlab-clinical-reports" ~/.claude/skills/alterlab-ieu-alterlab-academic-skills-alterlab-clinical-reports && rm -rf "$T"
skills/clinical-research/alterlab-clinical-reports/SKILL.mdClinical Report Writing
Overview
Document medical information with precision, accuracy, and regulatory compliance. This skill covers four report families: case reports for journal publication, diagnostic reports for clinical practice (radiology, pathology, lab), clinical trial reports for regulatory submission (SAE, CSR), and patient documentation for medical records (SOAP, H&P, discharge).
Critical principle: clinical reports must be accurate, complete, objective, and compliant with applicable regulations (HIPAA, FDA, ICH-GCP). Patient privacy and data integrity are paramount.
When to Use This Skill
Use when:
- Writing a clinical case report for journal submission (CARE guidelines)
- Creating a diagnostic report (radiology, pathology, laboratory)
- Documenting clinical trial data, SAE narratives, or a CSR (ICH-E3)
- Writing SOAP notes, H&P, discharge summaries, or consult notes
- Ensuring HIPAA compliance and proper de-identification
- Validating clinical documentation for completeness and accuracy
Core Workflow
- Pick the report family and load its detailed reference (see index below).
- Draft from the template in
for that report type.assets/ - Apply regulatory controls — de-identify, document consent, meet timelines.
- Validate with the matching
validator before sign-out.scripts/ - Final QA against the checklist at the end of this file.
1. Case reports for journal publication
Follow the CARE (CAse REport) checklist: title, keywords, structured abstract, introduction, patient information, clinical findings, timeline, diagnostic assessment, therapeutic interventions, follow-up/outcomes, discussion, patient perspective, and informed consent. Mind journal-specific limits (word count, figures, reference style) and de-identify before submission. → Element-by-element detail, journal requirements, and the 18 HIPAA identifiers:
references/care_report_sections.md. High-level checklist: references/case_report_guidelines.md.
2. Diagnostic reports (radiology, pathology, laboratory)
Each uses a standardized section structure (demographics → indication → technique → comparison → findings → impression for radiology; gross/microscopic/diagnosis for pathology; results with reference ranges and critical-value reporting for lab). Use structured-reporting templates (BI-RADS, Lung-RADS, CAP synoptic) where they apply. → Full section templates:
references/diagnostic_report_templates.md.
Standards and lexicons (ACR, CAP, LOINC): references/diagnostic_reports_standards.md.
3. Clinical trial reports (SAE, CSR, deviations)
SAE reports document serious adverse events with causality and expectedness, on strict regulatory timelines (7/15 days). CSRs follow the ICH-E3 section structure for regulatory submission. Protocol deviations are categorized (minor/major/violation) with CAPA documentation. → Component-by-component structures:
references/clinical_trial_report_structures.md.
Regulatory framing (ICH-E3, CONSORT, timelines): references/clinical_trial_reporting.md.
4. Patient documentation (SOAP, H&P, discharge)
SOAP notes for progress, H&P for admission/initial encounters, discharge summaries for handoff to outpatient providers. Use standard abbreviations, sign and date, document medical necessity for billing. → Format structures:
references/patient_record_formats.md.
Coding and documentation guidance: references/patient_documentation.md.
Regulatory Compliance and Privacy
- HIPAA: minimum-necessary disclosure; de-identify via Safe Harbor (remove 18 identifiers) or Expert Determination; Business Associate Agreements for third parties.
- FDA: 21 CFR Part 11 (e-records/signatures), Part 50 (consent), Part 56 (IRB), Part 312 (IND).
- ICH-GCP: protocol adherence, consent documentation, source-document requirements, audit trails, investigator responsibilities.
⚠️ Caveat — automated de-identification is NOT a compliance guarantee. The bundled
is a pure regex scan. Pattern matching has known, substantial false-negative rates: it misses unconventional name spellings, free-text dates, narrative addresses, rare identifiers, and anything outside its fixed patterns. It is a rough first-pass screen only — not a substitute for line-by-line manual review by a qualified person, and not a validated de-identification tool (e.g., Microsoft Presidio, Philter, or a certified Expert Determination). Passing this script does not establish HIPAA Safe Harbor compliance and must never be relied upon as a privacy guarantee. Always perform manual review before any disclosure or publication.scripts/check_deidentification.py
Detailed guidance:
references/regulatory_compliance.md.
Medical Terminology and Standards
Use standardized nomenclature: SNOMED CT (clinical terms), LOINC (lab/clinical observations), ICD-10-CM (diagnosis coding), CPT (procedure coding). Respect the Joint Commission "Do Not Use" abbreviation list (e.g. write "unit" not "U", always use a leading zero, never a trailing zero). Comprehensive standards:
references/medical_terminology.md.
Data Presentation
Tables for demographics, adverse events, lab values over time, and efficacy outcomes; figures for Kaplan-Meier curves, forest plots, CONSORT flow diagrams, and case-report timelines. Images must be ≥300 dpi, de-identified, with consent for recognizable patients. Detail:
references/data_presentation.md.
Quality Assurance
Documentation must be complete, accurate, timely, clear, and compliant. Use the per-type validation checklists (CARE, diagnostic completeness, SAE regulatory compliance, billing requirements) and the
scripts/ validators.
Workflows by Report Type
- Case report: identify case + consent → literature review → draft (CARE) → internal review → journal selection/submission → revision.
- Diagnostic report: review indication/priors → interpret → dictate structured report → peer review (complex cases) → sign-out → critical-value notification. STAT <1h, routine 24-48h.
- SAE report: identify → assess/document → causality + expectedness → review → submit to sponsor/IRB/FDA → follow-up to resolution (24h-15 days).
- CSR: database lock → analysis per SAP → medical-writer draft → biostat/clinical review → QC → approval/submission (6-12 months post-completion).
Index of Bundled Resources
References (references/
)
references/
— CARE element-by-element, journal requirements, 18 HIPAA identifierscare_report_sections.md
— CARE guidelines, journal requirements, writing tipscase_report_guidelines.md
— radiology/pathology/lab section templatesdiagnostic_report_templates.md
— ACR, CAP, laboratory reporting standardsdiagnostic_reports_standards.md
— SAE/CSR/deviation component structuresclinical_trial_report_structures.md
— ICH-E3, CONSORT, SAE reporting, CSR structureclinical_trial_reporting.md
— SOAP/H&P/discharge section formatspatient_record_formats.md
— SOAP, H&P, discharge, codingpatient_documentation.md
— HIPAA, 21 CFR Part 11, ICH-GCP, FDAregulatory_compliance.md
— SNOMED, LOINC, ICD-10, abbreviationsmedical_terminology.md
— tables, figures, safety data, CONSORT diagramsdata_presentation.md
— review criteria for clinical manuscriptspeer_review_standards.md
Template assets (assets/
)
assets/case_report_template.md, radiology_report_template.md, pathology_report_template.md,
lab_report_template.md, clinical_trial_sae_template.md, clinical_trial_csr_template.md,
soap_note_template.md, history_physical_template.md, discharge_summary_template.md,
consult_note_template.md, quality_checklist.md, hipaa_compliance_checklist.md.
Automation scripts (scripts/
)
scripts/validate_case_report.py, validate_trial_report.py, check_deidentification.py,
format_adverse_events.py, generate_report_template.py, extract_clinical_data.py,
compliance_checker.py, terminology_validator.py.
Integration with Other Skills
Pairs with scientific-writing (clear medical prose), peer-review (quality assessment), citation-mgmt (literature references), research-grants (protocol development), and literature-review (background sections).
Common Pitfalls
- Case reports: privacy violations, lack of novelty, insufficient detail, weak literature review, overgeneralization from a single case.
- Diagnostic reports: vague language, incomplete comparison, missing clinical correlation, delayed critical-value notification.
- Trial reports: late SAE reporting, incomplete causality, data inconsistencies, unreported deviations, selective reporting.
- Patient documentation: copy-forward errors, insufficient detail affecting billing, missing medical necessity, unsigned/undated notes.
Final Checklist
Before finalizing any clinical report, verify:
- All required sections complete
- Patient privacy protected (HIPAA compliance)
- Informed consent obtained (if applicable)
- Accurate and verified clinical data
- Appropriate medical terminology and coding
- Clear, professional language
- Proper formatting per guidelines
- References cited appropriately
- Figures and tables labeled correctly
- Spell-checked and proofread
- Regulatory requirements met
- Institutional policies followed
- Signatures and dates present
- Quality assurance review completed
Final note: clinical report quality directly impacts patient safety, healthcare delivery, and medical knowledge. Always prioritize accuracy, privacy, and professionalism.