scientific-skills/clinical-reports/SKILL.md
Clinical report writing is the process of documenting medical information with precision, accuracy, and compliance with regulatory standards. This skill covers four major categories of clinical reports: case reports for journal publication, diagnostic reports for clinical practice, clinical trial reports for regulatory submission, and patient documentation for medical records. Apply this skill for healthcare documentation, research dissemination, and regulatory compliance.
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. All clinical documentation must support evidence-based decision-making and meet professional standards.
This skill should be used when:
⚠️ MANDATORY: Every clinical report MUST include at least 1 AI-generated figure using the scientific-schematics skill.
This is not optional. Clinical reports benefit greatly from visual elements. Before finalizing any document:
How to generate figures:
How to generate schematics:
python scripts/generate_schematic.py "your diagram description" -o figures/output.png
The AI will automatically:
When to add schematics:
For detailed guidance on creating schematics, refer to the scientific-schematics skill documentation.
Clinical case reports describe unusual clinical presentations, novel diagnoses, or rare complications. They contribute to medical knowledge and are published in peer-reviewed journals.
The CARE (CAse REport) guidelines provide a standardized framework for case report writing. All case reports should follow this checklist:
Title
Keywords
Abstract (structured or unstructured, 150-250 words)
Introduction
Patient Information
Clinical Findings
Timeline
Diagnostic Assessment
Therapeutic Interventions
Follow-up and Outcomes
Discussion
Patient Perspective (optional but encouraged)
Informed Consent
For detailed CARE guidelines, refer to references/case_report_guidelines.md.
Different journals have specific formatting requirements:
Check journal instructions for authors before submission.
18 HIPAA Identifiers to Remove or Alter:
Best Practices:
Diagnostic reports communicate findings from imaging studies, pathological examinations, and laboratory tests. They must be clear, accurate, and actionable.
Radiology reports follow a standardized structure to ensure clarity and completeness.
Standard Structure:
1. Patient Demographics
2. Clinical Indication
3. Technique
4. Comparison
5. Findings
6. Impression/Conclusion
Structured Reporting:
Many radiology departments use structured reporting templates for common examinations:
Structured reports improve consistency, reduce ambiguity, and facilitate data extraction.
For radiology reporting standards, see references/diagnostic_reports_standards.md.
Pathology reports document microscopic findings from tissue specimens and provide diagnostic conclusions.
Surgical Pathology Report Structure:
1. Patient Information
2. Specimen Information
3. Clinical History
4. Gross Description
5. Microscopic Description
6. Diagnosis
7. Comment (if needed)
Synoptic Reporting:
The College of American Pathologists (CAP) provides synoptic reporting templates for cancer specimens. These checklists ensure all relevant diagnostic elements are documented.
Key elements for cancer reporting:
Laboratory reports communicate test results for clinical specimens (blood, urine, tissue, etc.).
Standard Components:
1. Patient and Specimen Information
2. Test Name and Method
3. Results
4. Interpretation (when applicable)
5. Quality Control Information
Critical Value Reporting:
For laboratory standards and terminology, see references/diagnostic_reports_standards.md.
Clinical trial reports document the conduct, results, and safety of clinical research studies. These reports are essential for regulatory submissions and scientific publication.
SAE reports document unexpected serious adverse reactions during clinical trials. Regulatory requirements mandate timely reporting to IRBs, sponsors, and regulatory agencies.
Definition of Serious Adverse Event: An adverse event is serious if it:
SAE Report Components:
1. Study Information
2. Patient Information (De-identified)
3. Event Information
4. Causality Assessment
5. Action Taken
6. Expectedness
7. Narrative
8. Reporter Information
Regulatory Timelines:
For detailed SAE reporting guidance, see references/clinical_trial_reporting.md.
Clinical study reports are comprehensive documents summarizing the design, conduct, and results of clinical trials. They are submitted to regulatory agencies as part of drug approval applications.
ICH-E3 Structure:
The ICH E3 guideline defines the structure and content of clinical study reports.
Main Sections:
1. Title Page
2. Synopsis (5-15 pages)
3. Table of Contents
4. List of Abbreviations and Definitions
5. Ethics (Section 2)
6. Investigators and Study Administrative Structure (Section 3)
7. Introduction (Section 4)
8. Study Objectives and Plan (Section 5)
9. Study Patients (Section 6)
10. Efficacy Evaluation (Section 7)
11. Safety Evaluation (Section 8)
12. Discussion and Overall Conclusions (Section 9)
13. Tables, Figures, and Graphs (Section 10)
14. Reference List (Section 11)
15. Appendices (Section 12)
Key Principles:
For ICH-E3 templates and detailed guidance, see references/clinical_trial_reporting.md and assets/clinical_trial_csr_template.md.
Protocol deviations are departures from the approved study protocol. They must be documented, assessed, and reported.
Categories:
Documentation Requirements:
Patient documentation records clinical encounters, progress, and care plans. Accurate documentation supports continuity of care, billing, and legal protection.
SOAP notes are the most common format for progress notes in clinical practice.
Structure:
S - Subjective
O - Objective
A - Assessment
P - Plan
Documentation Tips:
For SOAP note templates and examples, see assets/soap_note_template.md.
The H&P is a comprehensive assessment performed at admission or initial encounter.
Components:
1. Chief Complaint (CC)
2. History of Present Illness (HPI)
3. Past Medical History (PMH)
4. Medications
5. Allergies
6. Family History (FH)
7. Social History (SH)
8. Review of Systems (ROS)
9. Physical Examination
10. Assessment and Plan
For H&P templates, see assets/history_physical_template.md.
Discharge summaries document the hospital stay and communicate care plan to outpatient providers.
Required Elements:
1. Patient Identification
2. Reason for Hospitalization
3. Hospital Course
4. Discharge Diagnoses
5. Procedures Performed
6. Discharge Medications
7. Discharge Condition
8. Discharge Disposition
9. Follow-up Plans
10. Patient Instructions
Best Practices:
For discharge summary templates, see assets/discharge_summary_template.md.
The Health Insurance Portability and Accountability Act (HIPAA) mandates protection of patient health information.
Key Requirements:
De-identification Methods:
Business Associate Agreements: Required when PHI is shared with third parties for services
For detailed HIPAA guidance, see references/regulatory_compliance.md.
Clinical trial documentation must comply with FDA regulations:
Good Clinical Practice (GCP) guidelines ensure quality and ethical standards in clinical trials:
For ICH-GCP compliance, see references/regulatory_compliance.md.
SNOMED CT (Systematized Nomenclature of Medicine - Clinical Terms)
LOINC (Logical Observation Identifiers Names and Codes)
ICD-10-CM (International Classification of Diseases, 10th Revision, Clinical Modification)
CPT (Current Procedural Terminology)
Acceptable Abbreviations: Use standard abbreviations to improve efficiency while maintaining clarity.
Do Not Use List (Joint Commission):
For comprehensive terminology standards, see references/medical_terminology.md.
Completeness:
Accuracy:
Timeliness:
Clarity:
Compliance:
For each report type, use validation checklists to ensure quality:
Validation scripts are available in the scripts/ directory.
Tables for Clinical Data:
Table Design Principles:
Figures for Clinical Data:
Image Guidelines:
For data presentation standards, see references/data_presentation.md.
This clinical reports skill integrates with:
Phase 1: Case Identification and Consent (Week 1)
Phase 2: Literature Review (Week 1-2)
Phase 3: Drafting (Week 2-3)
Phase 4: Internal Review (Week 3-4)
Phase 5: Journal Selection and Submission (Week 4-5)
Phase 6: Revision (Variable)
Real-time Workflow:
Turnaround Time Benchmarks:
SAE Report: 24 hours to 15 days
CSR: 6-12 months post-study completion
This skill includes comprehensive reference files and templates:
references/case_report_guidelines.md - CARE guidelines, journal requirements, writing tipsreferences/diagnostic_reports_standards.md - ACR, CAP, laboratory reporting standardsreferences/clinical_trial_reporting.md - ICH-E3, CONSORT, SAE reporting, CSR structurereferences/patient_documentation.md - SOAP notes, H&P, discharge summaries, codingreferences/regulatory_compliance.md - HIPAA, 21 CFR Part 11, ICH-GCP, FDA requirementsreferences/medical_terminology.md - SNOMED, LOINC, ICD-10, abbreviations, nomenclaturereferences/data_presentation.md - Tables, figures, safety data, CONSORT diagramsreferences/peer_review_standards.md - Review criteria for clinical manuscriptsassets/case_report_template.md - Structured case report following CARE guidelinesassets/radiology_report_template.md - Standard radiology report formatassets/pathology_report_template.md - Surgical pathology report with synoptic elementsassets/lab_report_template.md - Clinical laboratory report formatassets/clinical_trial_sae_template.md - Serious adverse event report formassets/clinical_trial_csr_template.md - Clinical study report outline per ICH-E3assets/soap_note_template.md - SOAP progress note formatassets/history_physical_template.md - Comprehensive H&P templateassets/discharge_summary_template.md - Hospital discharge summaryassets/consult_note_template.md - Consultation note formatassets/quality_checklist.md - Quality assurance checklist for all report typesassets/hipaa_compliance_checklist.md - Privacy and de-identification checklistscripts/validate_case_report.py - Check CARE guideline compliance and completenessscripts/validate_trial_report.py - Verify ICH-E3 structure and required elementsscripts/check_deidentification.py - Scan for 18 HIPAA identifiers in textscripts/format_adverse_events.py - Generate AE summary tables from datascripts/generate_report_template.py - Interactive template selection and generationscripts/extract_clinical_data.py - Parse structured data from clinical reportsscripts/compliance_checker.py - Verify regulatory compliance requirementsscripts/terminology_validator.py - Validate medical terminology and codingLoad these resources as needed when working on specific clinical reports.
Before finalizing any clinical report, verify:
Final Note: Clinical report writing requires attention to detail, medical accuracy, regulatory compliance, and clear communication. Whether documenting patient care, reporting research findings, or communicating diagnostic results, the quality of clinical reports directly impacts patient safety, healthcare delivery, and medical knowledge advancement. Always prioritize accuracy, privacy, and professionalism in all clinical documentation.