Skip to content

foryourhealth111-pixel/Vibe-Skills / bundled/skills/clinical-reports

clinical-reports

Verified

Write comprehensive clinical reports including case reports (CARE guidelines), diagnostic reports (radiology/pathology/lab), clinical trial reports (ICH-E3, SAE, CSR), and patient documentation (SOAP, H&P, discharge summaries). Full support with templates, regulatory compliance (HIPAA, FDA, ICH-GCP), and validation tools.

references/README.md

View on GitHub
# Clinical Reports Skill

## Overview

Comprehensive skill for writing clinical reports including case reports, diagnostic reports, clinical trial reports, and patient documentation. Provides full support with templates, regulatory compliance, and validation tools.

## What's Included

### šŸ“‹ Four Major Report Types

1. **Clinical Case Reports** - CARE-compliant case reports for medical journal publication
2. **Diagnostic Reports** - Radiology (ACR), pathology (CAP), and laboratory reports
3. **Clinical Trial Reports** - SAE reports, Clinical Study Reports (ICH-E3), DSMB reports
4. **Patient Documentation** - SOAP notes, H&P, discharge summaries, consultation notes

### šŸ“š Reference Files (8 comprehensive guides)

- `case_report_guidelines.md` - CARE guidelines, de-identification, journal requirements
- `diagnostic_reports_standards.md` - ACR, CAP, CLSI standards, structured reporting systems
- `clinical_trial_reporting.md` - ICH-E3, CONSORT, SAE reporting, MedDRA coding
- `patient_documentation.md` - SOAP notes, H&P, discharge summary standards
- `regulatory_compliance.md` - HIPAA, 21 CFR Part 11, ICH-GCP, FDA regulations
- `medical_terminology.md` - SNOMED-CT, LOINC, ICD-10, CPT codes
- `data_presentation.md` - Clinical tables, figures, Kaplan-Meier curves
- `peer_review_standards.md` - Review criteria for clinical manuscripts

### šŸ“„ Templates (12 professional templates)

- `case_report_template.md` - Structured case report following CARE guidelines
- `soap_note_template.md` - SOAP progress note format
- `history_physical_template.md` - Complete H&P examination template
- `discharge_summary_template.md` - Hospital discharge documentation
- `consult_note_template.md` - Specialist consultation format
- `radiology_report_template.md` - Imaging report with structured reporting
- `pathology_report_template.md` - Surgical pathology with CAP synoptic elements
- `lab_report_template.md` - Clinical laboratory test results
- `clinical_trial_sae_template.md` - Serious adverse event report form
- `clinical_trial_csr_template.md` - Clinical study report outline (ICH-E3)
- `quality_checklist.md` - Quality assurance for all report types
- `hipaa_compliance_checklist.md` - Privacy and de-identification verification

### šŸ”§ Validation Scripts (8 automation tools)

- `validate_case_report.py` - Check CARE guideline compliance and completeness
- `check_deidentification.py` - Scan for 18 HIPAA identifiers in reports
- `validate_trial_report.py` - Verify ICH-E3 structure and required elements
- `format_adverse_events.py` - Generate AE summary tables from CSV data
- `generate_report_template.py` - Interactive template selection and generation
- `extract_clinical_data.py` - Parse and extract structured clinical data
- `compliance_checker.py` - Verify regulatory compliance requirements
- `terminology_validator.py` - Validate medical terminology and prohibited abbreviations

## Quick Start

### Generate a Template

```bash
cd .claude/skills/clinical-reports/scripts
python generate_report_template.py

# Or specify type directly
python generate_report_template.py --type case_report --output my_case_report.md
```

### Validate a Case Report

```bash
python validate_case_report.py my_case_report.md
```

### Check De-identification

```bash
python check_deidentification.py my_case_report.md
```

### Validate Clinical Trial Report

```bash
python validate_trial_report.py my_csr.md
```

## Key Features

### CARE Guidelines Compliance
- Complete CARE checklist coverage
- De-identification verification
- Informed consent documentation
- Timeline creation assistance
- Literature review integration

### Regulatory Compliance
- **HIPAA** - Privacy protection, 18 identifier removal, Safe Harbor method
- **FDA** - 21 CFR Parts 11, 50, 56, 312 compliance
- **ICH-GCP** - Good Clinical Practice standards
- **ALCOA-CCEA** - Data integrity principles

### Professional Standards
- **ACR** - American College of Radiology reporting standards
- **CAP** - College of American Pathologists synoptic reporting
- **CLSI** - Clinical Laboratory Standards Institute
- **CONSORT** - Clinical trial reporting
- **ICH-E3** - Clinical study report structure

### Medical Coding Systems
- **ICD-10-CM** - Diagnosis coding
- **CPT** - Procedure coding
- **SNOMED-CT** - Clinical terminology
- **LOINC** - Laboratory observation codes
- **MedDRA** - Medical dictionary for regulatory activities

## Common Use Cases

### 1. Publishing a Clinical Case Report

```
> Create a clinical case report for a 65-year-old patient with atypical 
  presentation of acute appendicitis

> Check this case report for HIPAA compliance
> Validate against CARE guidelines
```

### 2. Writing Diagnostic Reports

```
> Generate a radiology report template for chest CT
> Create a pathology report for colon resection specimen with adenocarcinoma
> Write a laboratory report for complete blood count
```

### 3. Clinical Trial Documentation

```
> Write a serious adverse event report for hospitalization due to pneumonia
> Create a clinical study report outline for phase 3 diabetes trial
> Generate adverse events summary table from trial data
```

### 4. Patient Clinical Notes

```
> Create a SOAP note for follow-up visit
> Generate an H&P for patient admitted with chest pain
> Write a discharge summary for heart failure hospitalization
> Create a cardiology consultation note
```

## Workflow Examples

### Case Report Workflow

1. **Obtain informed consent** from patient
2. **Generate template**: `python generate_report_template.py --type case_report`
3. **Write case report** following CARE structure
4. **Validate compliance**: `python validate_case_report.py case_report.md`
5. **Check de-identification**: `python check_deidentification.py case_report.md`
6. **Submit to journal** with CARE checklist

### Clinical Trial SAE Workflow

1. **Generate SAE template**: `python generate_report_template.py --type sae`
2. **Complete SAE form** within 24 hours of event
3. **Assess causality** using WHO-UMC or Naranjo criteria
4. **Validate completeness**: `python validate_trial_report.py sae_report.md`
5. **Submit to sponsor** within regulatory timelines (7 or 15 days)
6. **Notify IRB** per institutional policy

## Best Practices

### Privacy and Ethics
āœ“ Always obtain informed consent for case reports  
āœ“ Remove all 18 HIPAA identifiers before publication  
āœ“ Use de-identification validation scripts  
āœ“ Document consent in manuscript  
āœ“ Consider re-identification risk for rare conditions  

### Clinical Quality
āœ“ Use professional medical terminology  
āœ“ Follow structured reporting templates  
āœ“ Include all required elements  
āœ“ Document chronology clearly  
āœ“ Support diagnoses with evidence  

### Regulatory Compliance
āœ“ Meet SAE reporting timelines (7-day, 15-day)  
āœ“ Follow ICH-E3 structure for CSRs  
āœ“ Maintain ALCOA-CCEA data integrity  
āœ“ Document protocol adherence  
āœ“ Use MedDRA coding for adverse events  

### Documentation Standards
āœ“ Sign and date all clinical notes  
āœ“ Document medical necessity  
āœ“ Use standard abbreviations only  
āœ“ Avoid prohibited abbreviations (JCAHO "Do Not Use" list)  
āœ“ Maintain legibility and completeness  

## Integration

The clinical-reports skill integrates seamlessly with:

- **scientific-writing** - For clear, professional medical writing
- **peer-review** - For quality assessment of case reports
- **citation-management** - For literature references in case reports
- **research-grants** - For clinical trial protocol development

## Resources

### External Standards
- CARE Guidelines: https://www.care-statement.org/
- ICH-E3 Guideline: https://database.ich.org/sites/default/files/E3_Guideline.pdf
- CONSORT Statement: http://www.consort-statement.org/
- HIPAA: https://www.hhs.gov/hipaa/
- ACR Practice Parameters: https://www.acr.org/Clinical-Resources/Practice-Parameters-and-Technical-Standards
- CAP Cancer Protocols: https://www.cap.org/protocols-and-guidelines

### Professional Organizations
- American Medical Association (AMA)
- American College of Radiology (ACR)
- College of American Pathologists (CAP)
- Clinical Laboratory Standards Institute (CLSI)
- International Council for Harmonisation (ICH)

## Support

For issues or questions about the clinical-reports skill:
1. Check the comprehensive reference files
2. Review templates for examples
3. Run validation scripts to identify issues
4. Consult the SKILL.md for detailed guidance

## License

Part of the Claude Scientific Writer project. See main LICENSE file.

writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 323kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall