Clinical Report Writing

SkillDocs & knowledge

Once added, your AI can write complete clinical documents — patient case reports, diagnostic reports, clinical trial reports, and everyday patient notes. It builds each document from templates and follows healthcare standards such as HIPAA, FDA, and ICH-GCP, so the output is structured the way clinicians and regulators expect.

Available today. Use it from your connected AI after setup.

Add the skill, then tell your AI which report you need — for example, a discharge summary or a radiology report — and share the relevant patient or study details. It will draft the document using the matching template.

Then ask your AI: use the Clinical Report Writing skill

What your AI can do with it

  • Draft patient case reports that follow CARE guidelines
  • Write diagnostic reports for radiology, pathology, and lab results
  • Prepare clinical trial reports, including study reports (ICH-E3, CSR) and serious adverse event (SAE) write-ups
  • Write SOAP notes, history and physical (H&P) notes, and discharge summaries
  • Structure documents to meet HIPAA, FDA, and ICH-GCP requirements
  • Start each document from a ready-made template

What this skill tells your AI

The instructions your AI receives, as published by alterlab-ieu/alterlab-academic-skills in skills/clinical-research/alterlab-clinical-reports/SKILL.md and read by ahel’s review.

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

  1. Pick the report family and load its detailed reference (see index below).
  2. Draft from the template in assets/ for that report type.
  3. Apply regulatory controls — de-identify, document consent, meet timelines.
  4. Validate with the matching scripts/ validator before sign-out.
  5. 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 scripts/check_deidentification.py 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.

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/)

  • care_report_sections.md — CARE element-by-element, journal requirements, 18 HIPAA identifiers
  • case_report_guidelines.md — CARE guidelines, journal requirements, writing tips
  • diagnostic_report_templates.md — radiology/pathology/lab section templates
  • diagnostic_reports_standards.md — ACR, CAP, laboratory reporting standards
  • clinical_trial_report_structures.md — SAE/CSR/deviation component structures
  • clinical_trial_reporting.md — ICH-E3, CONSORT, SAE reporting, CSR structure
  • patient_record_formats.md — SOAP/H&P/discharge section formats
  • patient_documentation.md — SOAP, H&P, discharge, coding
  • regulatory_compliance.md — HIPAA, 21 CFR Part 11, ICH-GCP, FDA
  • medical_terminology.md — SNOMED, LOINC, ICD-10, abbreviations
  • data_presentation.md — tables, figures, safety data, CONSORT diagrams
  • peer_review_standards.md — review criteria for clinical manuscripts

Template 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/)

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.

Signals

GitHub stars
66
Forks
13
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
alterlab-clinical-reports
Source
github.com/alterlab-ieu/alterlab-academic-skills