clinical-reports
The clinical-reports Claude Code skill generates compliant medical documentation including case reports following CARE guidelines, diagnostic reports for radiology and pathology, clinical trial reports meeting ICH-E3 standards, and patient records in SOAP and discharge summary formats. Use this skill when documenting medical cases for journal publication, creating diagnostic assessments, reporting clinical trial data and adverse events, preparing regulatory submissions, writing patient progress notes, or ensuring HIPAA compliance and documentation accuracy across healthcare settings.
git clone --depth 1 https://github.com/K-Dense-AI/claude-scientific-writer /tmp/clinical-reports && cp -r /tmp/clinical-reports/skills/clinical-reports ~/.claude/skills/clinical-reportsSKILL.md
# Clinical Report Writing ## Overview 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. ## When to Use This Skill This skill should be used when: - Writing clinical case reports for journal submission (CARE guidelines) - Creating diagnostic reports (radiology, pathology, laboratory) - Documenting clinical trial data and adverse events - Preparing clinical study reports (CSR) for regulatory submission - Writing patient progress notes, SOAP notes, and clinical summaries - Drafting discharge summaries, H&P documents, or consultation notes - Ensuring HIPAA compliance and proper de-identification - Validating clinical documentation for completeness and accuracy - Preparing serious adverse event (SAE) reports - Creating data safety monitoring board (DSMB) reports ## Visual Enhancement with Scientific Schematics **⚠️ 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: 1. Generate at minimum ONE schematic or diagram (e.g., patient timeline, diagnostic algorithm, or treatment workflow) 2. For case reports: include clinical progression timeline 3. For trial reports: include CONSORT flow diagram **How to generate figures:** - Use the **scientific-schematics** skill to generate AI-powered publication-quality diagrams - Simply describe your desired diagram in natural language - Nano Banana Pro will automatically generate, review, and refine the schematic **How to generate schematics:** ```bash python scripts/generate_schematic.py "your diagram description" -o figures/output.png ``` The AI will automatically: - Create publication-quality images with proper formatting - Review and refine through multiple iterations - Ensure accessibility (colorblind-friendly, high contrast) - Save outputs in the figures/ directory **When to add schematics:** - Patient case timelines and clinical progression diagrams - Diagnostic algorithm flowcharts - Treatment protocol workflows - Anatomical diagrams for case reports - Clinical trial participant flow diagrams (CONSORT) - Adverse event classification trees - Any complex concept that benefits from visualization For detailed guidance on creating schematics, refer to the scientific-schematics skill documentation. --- ## Core Capabilities ### 1. Clinical Case Reports for Journal Publication Clinical case reports describe unusual clinical presentations, novel diagnoses, or rare complications. They contribute to medical knowledge and are published in peer-reviewed journals. #### CARE Guidelines Compliance The CARE (CAse REport) guidelines provide a standardized framework for case report writing. All case reports should follow this checklist: **Title** - Include the words "case report" or "case study" - Indicate the area of focus - Example: "Unusual Presentation of Acute Myocardial Infarction in a Young Patient: A Case Report" **Keywords** - 2-5 keywords for indexing and searchability - Use MeSH (Medical Subject Headings) terms when possible **Abstract** (structured or unstructured, 150-250 words) - Introduction: What is unique or novel about the case? - Patient concerns: Primary symptoms and key medical history - Diagnoses: Primary and secondary diagnoses - Interventions: Key treatments and procedures - Outcomes: Clinical outcome and follow-up - Conclusions: Main takeaway or clinical lesson **Introduction** - Brief background on the medical condition - Why this case is novel or important - Literature review of similar cases (brief) - What makes this case worth reporting **Patient Information** - Demographics (age, sex, race/ethnicity if relevant) - Medical history, family history, social history - Relevant comorbidities - **De-identification**: Remove or alter 18 HIPAA identifiers - **Patient consent**: Document informed consent for publication **Clinical Findings** - Chief complaint and presenting symptoms - Physical examination findings - Timeline of symptoms (consider timeline figure or table) - Relevant clinical observations **Timeline** - Chronological summary of key events - Dates of symptoms, diagnosis, interventions, outcomes - Can be presented as a table or figure - Example format: - Day 0: Initial presentation with symptoms X, Y, Z - Day 2: Diagnostic test A performed, revealed finding B - Day 5: Treatment initiated with drug C - Day 14: Clinical improvement noted - Month 3: Follow-up examination shows complete resolution **Diagnostic Assessment** - Diagnostic tests performed (labs, imaging, procedures) - Results and interpretation - Differential diagnosis considered - Rationale for final diagnosis - Challenges in diagnosis **Therapeutic Interventions** - Medications (names, dosages, routes, duration) - Procedures or surgeries performed - Non-pharmacological interventions - Reasoning for treatment choices - Alternative treatments considered **Follow-up and Outcomes** - Clinical outcome (resolution, improvement, unchanged, worsened) - Follow-up duration and frequency - Long-term outcomes if available - Patient-reported outcomes - Adherence to treatment **Discussion** - Strengths and novelty of the case - How this case compares to existing li
Comprehensive citation management for academic research. Search Google Scholar and PubMed for papers, extract accurate metadata, validate citations, and generate properly formatted BibTeX entries. This skill should be used when you need to find papers, verify citation information, convert DOIs to BibTeX, or ensure reference accuracy in scientific writing.
Generate professional clinical decision support (CDS) documents for pharmaceutical and clinical research settings, including patient cohort analyses (biomarker-stratified with outcomes) and treatment recommendation reports (evidence-based guidelines with decision algorithms). Supports GRADE evidence grading, statistical analysis (hazard ratios, survival curves, waterfall plots), biomarker integration, and regulatory compliance. Outputs publication-ready LaTeX/PDF format optimized for drug development, clinical research, and evidence synthesis.
Document toolkit (.docx). Create/edit documents, tracked changes, comments, formatting preservation, text extraction, for professional document processing.
PDF manipulation toolkit. Extract text/tables, create PDFs, merge/split, fill forms, for programmatic document processing and analysis.
Presentation toolkit (.pptx). Create/edit slides, layouts, content, speaker notes, comments, for programmatic presentation creation and modification.
Spreadsheet toolkit (.xlsx/.csv). Create/edit with formulas/formatting, analyze data, visualization, recalculate formulas, for spreadsheet processing and analysis.
Generate or edit images using AI models (FLUX, Gemini). Use for general-purpose image generation including photos, illustrations, artwork, visual assets, concept art, and any image that isn't a technical diagram or schematic. For flowcharts, circuits, pathways, and technical diagrams, use the scientific-schematics skill instead.
Generate testable hypotheses. Formulate from observations, design experiments, explore competing explanations, develop predictions, propose mechanisms, for scientific inquiry across domains.